pkg-config is a script to make putting together all the build flags when compiling/linking a lot easier.

Report bugs at http://bugzilla.freedesktop.org/

To use pkg-config, do something like the following in your configure.ac

PKG_CHECK_MODULES([GNOME], [gtk > 1.2.8 gnomeui >= 1.2.0])

This puts the neccesary include flags to compile/link something against libgnomeui and all its dependencies in $(GNOME_CFLAGS), and the -L/-l flags for linking in $(GNOME_LIBS).

Users can define the PKG_CONFIG environment variable to point at the right one, or if they cross-compile and have a correctly named pkg-config (eg. arm-linux-pkg-config) in their PATH that will be used in preference.

Users can also define the GNOME_CFLAGS and GNOME_LIBS environment variables if they think they know better, pkg-config will not be called if they do that.

The "gtk > 1.2.8" part is only neccesary if you want to specifically check if libgtk is version 1.2.8 or higher. Otherwise, the flags for gtk will be included automatically, since libgnomeui depends on gtk. So you could just say:

 PKG_CHECK_MODULES([GNOME], [gnomeui])

for any version of gnomeui.

For more info, there's even a man page, try 'man pkg-config'

Building

pkg-config depends on glib. Note that glib build-depends on pkg-config, but you can just set the corresponding environment variables (ZLIB_LIBS, ZLIB_CFLAGS are the only needed ones when this is written) to build it.

pkg-config also either needs an earlier version of itself to find glib or you need to set GLIB_CFLAGS and GLIB_LIBS to the correct values for where it's installed in your system.

If this requirement is too cumbersome, a bundled copy of a recent glib stable release is included. Pass --with-internal-glib to configure to use this copy.

If you're cross-compiling and you need to build the bundled glib, refer to the glib documentation for cross-compiling glib. In short, this will require setting some autoconf cache variables in cases where glib would need to run a program to determine the correct value. See the glib documentation:

http://developer.gnome.org/glib/stable/glib-cross-compiling.html

If you need to use the bundled glib on Mac OS X, you'll most likely need to build for a single architecture rather than as a universal binary. This is because glib (as of version 2.32) does not support building for multiple architectures out of the box. The glib2 from MacPorts or Homebrew may be available as a universal binary and usable for pkg-config as described above. Nothing in pkg-config itself precludes being built as a universal binary.