Επιλογές γραμμής εντολών και σελίδες man
Δεδομένου ότι κάποιος μπορεί να παραγάγει σελίδες man για ένα docbook refentry επίσης, θα ήταν καλή ιδέα να χρησιμοποιηθεί και για αυτόν τον σκοπό. Με αυτόν τον τρόπο η διεπαφή γίνεται μέρος της αναφοράς και αποχτά την σελίδα-man δωρεάν.
6.1.1. Τεκμηρίωση του εργαλείου
Δημιουργήστε ένα refentry αρχείο ανά εργαλείο. Ακολουθώντας το παράδειγμά μας θα το ονομάσουμε meep/docs/reference/meeper/meep.xml. Για τις ετικέτες xml που πρέπει να χρησιμοποιηθούν και μπορούν να εξετάσουν το παραγόμενο αρχείο στον υποκατάλογο xml καθώς επίσης και τα παραδείγματα π.χ. στο glib.
6.1.2. Προσθήκη του έξτρα ελέγχου διαμόρφωσης
Παράδειγμα 6-1 Έξτρα έλεγχοι διαμόρφωσης
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. Προσθήκη των έξτρα κανόνων makefile
Παράδειγμα 6-2 Έξτρα έλεγχοι διαμόρφωσης
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