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 117e11df8b38612a21c7a7ca1aa2c3dde7ba45c5..4b41e6b580fa6017203d5573cd1effa2195a7ee1 100644 (file)
--- 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 \
        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 \
        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
 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
 else
 if BUILD_PDF_USING_FOP

-XMLTO_PDF_WITH = --with-fop
+XMLTO_PDF_OPTS = --with-fop

 else
 else

-XMLTO_PDF_WITH =
+XMLTO_PDF_OPTS =

 endif
 endif
 
 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
 
 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
 
 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 (file)
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>