
## INSTALLING

Gtkmenuplus can be built with the standard GNU autotools and make.

The default configuration builds for GTK2. See below for GTK3 builds.

Examples - run these inside the top directory:

1. Generate the Makefile from configure.ac and Makefile.am:

```sh
autoreconf -vif
```

2. Then build and install the package and its manuals:

```sh
( mkdir -p build && cd build && ../configure && make && make install-strip install-man )
```

Notice that the binary is stripped in the `make install-strip` step, and you
need to explicitly install manual pages with `install-man`.

3. Build with debugging symbols, and install the package into the build directory:

```sh
( mkdir -p build-debug && cd build-debug && ../configure --prefix=`pwd` CFLAGS='-g' && make all install)
```

4. Build and install for GTK3 with standard options enabled:

```sh
mkdir build-gtk3
( cd build-gtk3 && ../configure --with-gtk=gtk3 && make && make install-strip install-man )
```

5. If you are on a 64-bit architecture with multilib installed and 32-bit
libraries in /usr/lib, build a 32-bit binary, and install the package into the
build directory:

```
mkdir build-32
( cd build-32 && ../configure --prefix=`pwd` --build=i686-linux-gnu --libdir=/usr/lib "CFLAGS=-m32 -L/usr/lib" && make && make install-strip install-man )
```

6. View all build options and flags:

```sh
./configure --help
```

specifically:

```
  --enable-debug-if       Enable debugging output for gtkmenuplus IF command
  --enable-deprecated     Enable deprecated GTK functions (for GTK3 deprecated
                          functions are always enabled)
  --disable-activation-log
                          Disable gtkmenuplus activation log feature
  --disable-always-show-icons
                          Disable gtkmenuplus always showing menu icons
                          regardless of user's configuration
  --disable-cache         Disable gtkmenuplus cache feature
  --disable-launchers     Disable gtkmenuplus LAUNCHERS command
  --disable-format        Disable gtkmenuplus FORMAT command
  --disable-tooltips      Disable gtkmenuplus TOOLTIP command
  --disable-if            Disable gtkmenuplus IF command
  --disable-params        Disable gtkmenuplus menu parameters
  --disable-variables     Disable gtkmenuplus menu variables

  --with-gtk=gtk2|gtk3    set the GTK+ version to use (default - gtk2)
```

