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-1 Comprobaciones 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-2 Comprobaciones 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