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