[trac3520] add a "make pdf" target in the doc/guide directory

If dblatex is detected at configure time, the guide and log messages
documentation can be made in PDF format.

diff --git a/configure.ac b/configure.ac
index 5248ed4a5c551619d2551a0e7f62c4c624957127..916affb97f1580f47ff37991bb24faa63695a68d 100644 (file)
--- a/configure.ac
+++ b/configure.ac
@@ -1293,6 +1293,9 @@ if test "x$enable_generate_docs" != xno ; then
   fi
 fi
 
+# Don't fail here if not found, used to generate PDF documentation.
+AC_PATH_PROG([DBLATEX], [dblatex])
+AM_CONDITIONAL(HAVE_DBLATEX, test "x$DBLATEX" != "x")
 
 AM_CONDITIONAL(GENERATE_DOCS, test x$enable_generate_docs != xno)
 

diff --git a/doc/guide/Makefile.am b/doc/guide/Makefile.am
index 67be2065c2ab14e5e79d47a31c3ab2e9dadafe5a..6eebc0d723cdd2d7e2bebcde51e7b3a0daf62512 100644 (file)
--- a/doc/guide/Makefile.am
+++ b/doc/guide/Makefile.am
@@ -12,6 +12,9 @@ DOCBOOK += libdhcp.xml
 EXTRA_DIST = $(DOCBOOK)
 DISTCLEANFILES = $(HTMLDOCS) $(DOCS) kea-messages.xml
 
+kea-messages.xml:
+       $(PYTHON) $(top_srcdir)/tools/system_messages.py -o $@ $(top_srcdir)
+
 # This is not a "man" manual, but reuse this for now for docbook.
 if GENERATE_DOCS
 
@@ -36,13 +39,33 @@ kea-messages.html: kea-messages.xml
                http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl \
                kea-messages.xml
 
-kea-messages.xml:
-       $(PYTHON) $(top_srcdir)/tools/system_messages.py -o $@ $(top_srcdir)
-
 else
 
 $(HTMLDOCS) $(DOCS):
        @echo Doc generation disabled.  Creating dummy $@.  Configure with --enable-generate-docs to enable it.
        @echo Doc generation disabled.  Remove this file, configure with --enable-generate-docs, and rebuild Kea > $@
 
+endif 
+
+if HAVE_DBLATEX
+
+CLEANFILES = kea-guide.pdf kea-messages.pdf
+
+DBLATEX_FLAGS = --xslt-opts=--path --xslt-opts=$(abs_top_builddir)/doc \
+       -P doc.collab.show=0 -P latex.output.revhistory=0 \
+       --param=term.breakline=1
+
+pdf: kea-guide.pdf kea-messages.pdf
+
+kea-guide.pdf: $(DOCBOOK)
+       @DBLATEX@ $(DBLATEX_FLAGS) kea-guide.xml
+
+kea-messages.pdf: kea-messages.xml
+       @DBLATEX@ $(DBLATEX_FLAGS) kea-messages.xml
+
+else
+
+pdf kea-guide.pdf kea-messages.pdf:
+       @echo Install dblatex tool and rerun ./configure to be able to generate documentation in PDF format.
+
 endif