gnome

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.

Availability

You can find the latest tarball here:

ftp://ftp.home-of-linux.org/pub/gnome-common/

Usage

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:

<prefix>/share/aclocal/gnome-macros
All macros from the macros/ directory are installed here.
<prefix>/share/aclocal/gnome2-macros
This are the new macros from GNOME 2.0
<prefix>/bin/gnome-autogen.sh
A modified version of the autogen.sh 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).

autogen.sh

In the autogen.sh script of your package, you use the following:

. `gnome-config --bindir`/gnome-autogen.sh

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

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

. macros/autogen.sh

line in your autogen.sh. Simply replace it with the new one.

configure.in

You need to place

GNOME_COMMON_INIT

somewhere in your configure.in.

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

AM_ACLOCAL_INCLUDE(macros)

line in your configure.in. 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:

ftp://ftp.home-of-linux.org/pub/gnome-common/GnomeHello-0.1.tar.gz

Questions, Comments, …

If you have any questions, comments or suggestions feel free to ask (martin@home-of-linux.org).

GNOME 2.0

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`/gnome-autogen.sh

into your autogen.sh and remove the hack-macros/ directory.