Opciones de la línea de comandos y las páginas man

Ya que también se pueden generar páginas man para referencias de entrada docbook, parece buena idea usarlas para ese propósito. De esta forma la interfaz es parte de la referencia y se obtienen las páginas man sin trabajo.

6.1.1. Documentar la herramienta

Cree un archivo de entrada de referencia para cada herramienta. Siguiendo el ejemplo se llamará meep/docs/reference/meeper/meep.xml. Para las etiquetas xml que se deben usar puede mirar al archivo generado en el subdirectorio xml así como los ejemplos en, por ejemplo, glib.

6.1.2. Añadir la comprobación de configuración adicional

Ejemplo 6-1Comprobaciones de configuración adicionales
AC_ARG_ENABLE(man,
              [AC_HELP_STRING([--enable-man],
                              [regenerate man pages from Docbook [default=no]])],enable_man=yes,
              enable_man=no)

AC_PATH_PROG([XSLTPROC], [xsltproc])
AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)

            

6.1.3. Añadir reglas de makefile adicionales

Ejemplo 6-2Comprobaciones de configuración adicionales
man_MANS = \
       meeper.1

if ENABLE_GTK_DOC
if ENABLE_MAN

%.1 : %.xml
        @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $<

endif
endif

BUILT_EXTRA_DIST = $(man_MANS)
EXTRA_DIST += meep.xml