El único cambio que deberías tener en cuenta aquí es el hacer que el script autogen.sh de tu paquete llame al script gnome-autogen.sh con la variable de entorno USE_GNOME2_MACROS inicializada. Por ejemplo, observa el script sample autogen.sh que aparece más abajo. En general es bastante seguro simplemente copiar el autogen.sh de otro sitio, como por ejemplo de los módulos gnome-hello y luego símplemente modificar el nombre del paquete.

#!/bin/sh
# Run this to generate all the initial makefiles, etc.

srcdir=`dirname $0`
test -z "$srcdir" && srcdir=.

PKG_NAME="Gnome Hello Demonstration Application"

(test -f $srcdir/configure.in \
  && test -f $srcdir/ChangeLog \
  && test -d $srcdir/src) || {
    echo -n "**Error**: Directory "\`$srcdir\'" does not look like the"
    echo " top-level $PKG_NAME directory"
    exit 1
}

which gnome-autogen.sh || {
    echo "You need to install gnome-common from the GNOME CVS"
    exit 1
}
USE_GNOME2_MACROS=1 . gnome-autogen.sh
         

Como se mencionó en la corta descripción de pkg-config, ésta es la nueva forma de hacer las cosas que se hacían anteriormente con llamadas a scripts específicos de cada aplicación como gnome-config.

Puedes listar todas las bibliotecas que están bajo el control de pkg-config ejecutando el comando pkg-config --list-all. Si lo haces, verás que todas las bibliotecas que son parte de la plataforma GNOME 2 son conocidas pra pkg-config.

En la mayoría de los casos, es suficiente con buscar las bibliotecas de plataforma que aparecen en la parte superior del árbol de dependencias. Esto es, la biblioteca cuyas dependencias incluye a todas las otras bibliotecas que necesitarás. Normalmente, libgnomeui-2.0 suele ser suficiente, dado que sus dependencias incluyen a gtk+, gconf y libbonoboui entre otras. .

Si crees que necesitas algo más específico o más complejo que ésto, échale un vistazo a la página del manual de pkg-config para más información.

Para usar paquetes gestionados por pkg-config, todos los cambios están en configure.in,que se cubre en la sección sobre required changes to configure.in. Si lo que buscas es hacer usable tu propio paquete via pkg-config, entonces necesitas crear un fichero foo.pc apropiado (en caso de que tu paquete se llamara foo).

Normalmente, no crearías el fichero foo.pc directamente, dado que contiene información sobre las localizaciones de los componentes instalados de foo. En lugar de eso, crearías el fichero foo.pc.in con las variables apropiadas que serán luego rellenadas desde configure.in. A modo de ejemplo, aquí mostramos una pequeña variación del fichero gobject.pc.in (la línea Conflicts no es normal y hay algunos comentarios extra). Este fichero será luego convertido en gobject.pc gracias a una línea apropiadamente puesta en la sección AC_OUTPUT del fichero configure.in.

# This is a comment
prefix=@prefix@
exec_prefix=@exec_prefix@
libdir=@libdir@
includedir=@includedir@

Name: GObject                            # human-readable name
Description: Object/type system for GLib # human-readable description
Version: @VERSION@
Requires: glib-2.0 = 1.3.1
Conflicts: foobar <= 4.5
Libs: -L${libdir} -lgobject-1.3
Cflags: -I${includedir}/glib-2.0 -I${libdir}/glib/include
         

La mayor parte de lo aquí expuesto no debería sorprender demasiado a aquellas personas acostumbradas a compilar programas: especificar las bibliotecas requeridas, el enlazado y las opciones de C para este paquete y para cualquiera que entre en conflicto con éste. Para más ejemplos, observa la localización estándar donde pkg-config almacena los ficheros *.pc (normalmente $(prefix)/lib/pkgconfig/.

El fichero configure.in es probablemente el fichero que más cambios requiere de todos los que forman parte de la infraestructura de compilación de la aplicación. Hay varias razones para esto.

En GNOME 2, la necesidad de tener un subdirectorio macros/ para cada módulo CVS, conteniendo un grupo completo de macros .m4 comunes, ha sido eliminada. En su lugar, las macros comunes son parte del módulo gnome-common y normalmente estarán disponibles (cuando estén installadas) bajo el directorio $(prefix)/share/aclocal/gnome2-macros.

De forma similar, en general hay poca necesidad de usar gettext del directorio intl/ que aparece en la mayoría de los módulos, dado que gettext está por lo general ya instalado en la máquina del desarrollador.

Finalmente, se requieren algunos cambios dada la actualización de varias herramientas. Por ejemplo, algunos están recomendados como parte de la actualización a autoconf 2.52. Estos cambios permiten mejores mensajes de diagnóstico, la mayor parte de las veces. La inclusión de pkg-config también requerirá añadir unas cuantas llamadas.

Por supuesto, como en todas las sugerencias de este documento, si necesitas algo más complejo que lo anterior, seguro que ya sabes por qué necesitas algo diferente y tienes el suficiente conocimiento para cambiarlo. Este documento símplemente ofrece una lista de comprobación para la mayoría de las aplicaciones; no se asegura que funcione para aplicaciones con necesidades extrañas o para casos raros y especiales.

Ahora que las justificaciones ya han sido dadas, aquí se muestran los pasos que funcionarán en la mayoría de los casos:

Normalmente, no necesitarás realizar cambios significativos en tu Makefile.am, dado que símplemente contiene la cantidad mínima de información necesaria para poder compilar tu aplicación. Lo único necesario sería eliminar cualquier referencia a los directorios intl y macros en variables como DIST_SUBDIRS y SUBDIRS.