Επιλογές γραμμής εντολών και σελίδες 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