Kommandoradsflaggor och mansidor

Då man också kan generera mansidor för ett docbook-refentry, låter det som en bra idé att använda det för detta ändamål. På detta sättet kommer gränssnittet att vara en del av referensen och man får mansidan gratis.

7.1.1. Dokumentera verktyget

Skapa en refentry-fil per verktyg. Om du följer vårt exempel borde vi kalla det meep/docs/reference/meeper/meep.xml. För xml-taggarna bör detta användas och man kan studera den genererade filen i xml-underkatalogen så väl som exempel i glib.

7.1.2. Lägga till den extra configure-kontrollen

Exempel 7-1Lägga till extra configure-kontroller
AC_ARG_ENABLE(man,
              [AC_HELP_STRING([--enable-man],
                              [omgenerera mansidor från Docbook [standardvärde=no]])],enable_man=yes,
              enable_man=no)

AC_PATH_PROG([XSLTPROC], [xsltproc])
AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)

7.1.3. Lägga till de extra makefilsreglerna

Exempel 7-2Lägga till extra configure-kontroller
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