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-1 Lä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-2 Lä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