Opções de linha de comando e de páginas man
Já que também é possível gerar páginas man para um refentry do docbook, soa como uma boa ideia usá-lo para este propósito. Desta forma, a interface é parte da referência e é possível obter a página man de graça.
7.1.1. Documentar a ferramenta
Crie um arquivo refentry por ferramenta. Segundo nosso exemplo nós chamaríamos ele de meep/docs/reference/meeper/meep.xml. Para as tags xml que devem ser usadas e podem parecer no arquivo gerado no subdiretório xml assim como exemplos, por exemplo, em glib.
7.1.2. Adicionando a verificação extra ao configure
Example 7-1 Verificações extra no configure
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)
7.1.3. Adicionando as regras extras ao makefile
Example 7-2 Verificações extra no configure
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