Options de ligne de commande et pages de manuel

Comme il est possible de générer aussi des pages de manuel à partir d'une « refentry » DocBook, il semble donc intéressant de l'utiliser dans ce but. Ainsi, l'interface fait partie de la référence et l'on obtient en cadeau la page de manuel.

VI.I.I. Documentation de l'outil

Créez un fichier « refentry » par outil. En suivant notre exemple, nous l'appellerons meep/docs/reference/meeper/meep.xml. Pour connaître les balises XML pouvant être utilisées, on peut observer le fichier généré dans le sous-répertoire xml ou des exemples comme dans glib.

VI.I.II. Ajout de contrôles « configure » supplémentaires

Exemple VI.1 Contrôles « configure » supplémentaires
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)

            

VI.I.III. Ajout de règles « makefile » supplémentaires

Exemple VI.2 Contrôles « configure » supplémentaires
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