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.
- VII.I.I. Documentation de l'outil
- VII.I.II. Ajout de contrôles « configure » supplémentaires
- VII.I.III. Ajout de règles « makefile » supplémentaires
VII.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.
VII.I.II. Ajout de contrôles « configure » supplémentaires
Exemple VII.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)
VII.I.III. Ajout de règles « makefile » supplémentaires
Exemple VII.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