From: Ian Abbott <abbotti@mev.co.uk>
Date: Fri, 4 May 2012 15:32:35 +0000 (+0100)
Subject: doc: Use a stylesheet for dblatex
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=a3c29c87a8fd6e19196d7744fb02eecc1ae3aa34;p=comedilib.git

doc: Use a stylesheet for dblatex

Add comedilib_dblatex_config.xsl stylesheet and pass it to dblatex when
producing PDF output.  The current version of the stylesheet doesn't
make much difference to the output, but it's somewhere we can put stuff
later.

We probably want to do something similar for the other PDF backends, but
those are currently broken anyway.
---

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 117e11d..4b41e6b 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -9,6 +9,7 @@ EXTRA_DIST = $(XML) calibration_funcref.txt command_funcref.txt dio_funcref.txt
 	deprecated_funcref.txt error_funcref.txt extensions_funcref.txt \
 	funcref mkref drivers.txt mkdr FAQ \
 	acq-seq.gif doc_html man comedilib_html_config.xsl \
+	comedilib_dblatex_config.xsl \
 	comedilib.css
 
 BUILT_SOURCES = calibration_funcref.xml command_funcref.xml dio_funcref.xml \
@@ -38,12 +39,12 @@ dist_pdf_DATA =
 endif
 
 if BUILD_PDF_USING_DBLATEX
-XMLTO_PDF_WITH = --with-dblatex
+XMLTO_PDF_OPTS = --with-dblatex -p "-p $(abs_srcdir)/comedilib_dblatex_config.xsl"
 else
 if BUILD_PDF_USING_FOP
-XMLTO_PDF_WITH = --with-fop
+XMLTO_PDF_OPTS = --with-fop
 else
-XMLTO_PDF_WITH =
+XMLTO_PDF_OPTS =
 endif
 endif
 
@@ -82,8 +83,8 @@ install_man:
 uninstall_man:
 	for each in `find $(srcdir)/man/ -name '*.3'`; do $(RM) $(DESTDIR)$(mandir)/man3/`basename $$each` ; done
 
-$(srcdir)/pdf/comedilib.pdf: $(XML)
-	$(XMLTO) -o $(srcdir)/pdf --skip-validation $(XMLTO_PDF_WITH) pdf $(srcdir)/comedilib.xml
+$(srcdir)/pdf/comedilib.pdf: $(XML) comedilib_dblatex_config.xsl
+	$(XMLTO) -o $(srcdir)/pdf --skip-validation $(XMLTO_PDF_OPTS) pdf $(srcdir)/comedilib.xml
 
 funcref.xml: funcref mkref
 	$(srcdir)/mkref $(srcdir)/funcref >$(srcdir)/funcref.xml
diff --git a/doc/comedilib_dblatex_config.xsl b/doc/comedilib_dblatex_config.xsl
new file mode 100644
index 0000000..33ec45b
--- /dev/null
+++ b/doc/comedilib_dblatex_config.xsl
@@ -0,0 +1,7 @@
+<?xml version='1.0'?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+	xmlns:fo="http://www.w3.org/1999/XSL/Format"
+	version="1.0">
+	<xsl:param name="funcsynopsis.decoration" select="1"/>
+	<xsl:param name="funcsynopsis.style">ansi</xsl:param>
+</xsl:stylesheet>