The gnome-common Module

The gnome-common provides an easy way to use the GNOME autoconf macros in applications which are developed outside of the GNOME CVS tree.


You can find the latest tarball here:


First of all, you need to compile and install the gnome-common-1.2.0.tar.gz tarball just like any other package.

This tarball installs a couple of things:

All macros from the macros/ directory are installed here.
This are the new macros from GNOME 2.0
A modified version of the from the macros/ directory.

If you previously had a macros/ directory in your package, you can now remove it (when you have your package in the GNOME CVS tree, this is done in the CVSROOT/modules file; to do this, look for a line starting with the name of your module and remove the &macros from it).

In the script of your package, you use the following:

. `gnome-config --bindir`/

This calls the script which was installed by gnome-common.

If you were previously using the macros/ directory, then you should find a

. macros/

line in your Simply replace it with the new one.

You need to place


somewhere in your

If you were previously using the macros/ directory, then you should find a


line in your Simply replace it with GNOME_COMMON_INIT.

Sample Usage

I made a modified gnome-hello module which uses gnome-common instead of the macros/ directory which can be found here:

Questions, Comments, …

If you have any questions, comments or suggestions feel free to ask (


This section is only intended for “hackers”.

You can also use the gnome-common module for GNOME 2.0 applications like nautilus.

To do this, you need to put

USE_GNOME_2_MACROS=1 . `gnome-config --bindir`/

into your and remove the hack-macros/ directory.