Επιλογές γραμμής εντολών και σελίδες τεκμηρίωσης man

Δεδομένου ότι κάποιος μπορεί να παραγάγει σελίδες man για ένα docbook refentry επίσης, θα ήταν καλή ιδέα να χρησιμοποιηθεί και για αυτόν τον σκοπό. Με αυτόν τον τρόπο η διεπαφή γίνεται μέρος της αναφοράς και αποκτά δωρεάν την σελίδα-man.

7.1.1. Τεκμηρίωση του εργαλείου

Δημιουργήστε ένα refentry αρχείο ανά εργαλείο. Ακολουθώντας το παράδειγμά μας θα το ονομάσουμε meep/docs/reference/meeper/meep.xml. Για τις ετικέτες xml που πρέπει να χρησιμοποιηθούν και μπορούν να εξετάσουν το παραγόμενο αρχείο στον υποκατάλογο xml καθώς επίσης και τα παραδείγματα π.χ. στο glib.

7.1.2. Προσθήκη του έξτρα ελέγχου διαμόρφωσης

Παράδειγμα 7-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)

7.1.3. Προσθήκη των επιπλέον κανόνων makefile

Παράδειγμα 7-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