Přepínače příkazového řádku a manuálové stránky

Protože je stejně možné generovat manuálové stránky pro referenční položky DocBook, zní jako dobrý nápad použít to pro tento účel. Tímto způsobem se rozhraní stane součástí referenční příručky a získáte tak bez námahy manuálovou stránku.

7.1.1. Dokumentování nástrojů

Vytvořte jeden soubor s referenční příručkou pro každý z nástrojů. V našem příkladu by se měl nazývat meep/docs/reference/meeper/meep.xml. Na značky XML, který by se měly použít, se podívejte do nějakého ukázkového vygenerovaného souboru v podsložce XML, například v glib.

7.1.2. Přidání doplňkových kontrol do configure

Příklad 7-1Dodatečné kontroly nastavení
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. Přidání doplňkových pravidel do Makefile

Příklad 7-2Dodatečné kontroly nastavení
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