How To?

Add Non-DocBook Extra documents

If the user wanted to include markdown.md (expanded) and latex.tex (as-is) in his documentation, he could write:

# configure.ac
AC_PATH_PROG([PANDOC], [pandoc], [no])
if test x$PANDOC = xno ; then
  AC_MSG_ERROR([pandoc not found.])
fi

# Makefile.am
%.xml: %.md
         $(PANDOC) --to=docbook4 --standalone --output $@ $<

%.xml: %.tex
         $(PANDOC) --to=docbook4 --standalone --output $@ $<

# Extra files that are included by $(DOC_MAIN_SGML_FILE).
# e.g. content_files=running.xml building.xml changes-2.0.xml
content_files = latex.xml

# Files where gtk-doc abbreviations (#GtkWidget) are expanded
# e.g. expand_content_files=running.xml
expand_content_files = markdown.xml