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.
also updated the tutorial. I've simplified the tut2.c
by using comedi2phys instead of comedi2physical. The use of
polynomials as a 2nd comedi program is a bit too difficult
for a novice and might deter the user to dig deeper into
the coding. Also, I've added tut3.c which is a stripped
down version of cmd.c and of that again the relevant lines
for the handbook to save space.
The PDF output of the table of configurations was awful. Fiddled with
the column widths a bit and simplified the layout "Meanings of data[1],..."
column to allow it to wrap.
Add --with-pdf-backend=[yes|no|dblatex|fop|default] option which
defaults to "yes". This controls the option passed to 'xmlto' to
generate PDFs.
If set to "yes" (the default) it looks for 'dblatex' and uses it as the
backend for 'xmlto' if found, otherwise 'xmlto' will use the default
backend.
If set to "no" (same as --without-pdf-backend), PDF generation is
disabled.
If set to "dblatex" it looks for 'dblatex' and uses it as the backend
for 'xmlto' if found, otherwise PDF generation is disabled.
If set to "fop" it looks for 'fop' and uses it as the backend
for 'xmlto' if found, otherwise PDF generation is disabled.
If set to "default", 'xmlto' will use the default backend.
Rebuilt "doc/drivers.txt" using "make Documentation/comedi/drivers.txt"
in the Comedi package. Note: this scans the driver sources included
with the comedi.org Comedi package, not the Linux "staging" Comedi
sources, so some newer, staging-only drivers are missing.
Signed-off-by: Ian Abbott <abbotti@mev.co.uk>
dblatex is passed the option `-o $(srcdir)/pdf`, but if this directory
does not exist, the PDF file is created with the name 'pdf' in
$(srcdir). Make the directory so that the -o option treats the
specified name as an output directory instead of an output filename.
dblatex -t pdf ./comedilib.xml
There were two major issues in the comedilb.xml:
1) there were too many nested sections so that
latex ran out of sub-sub-sub-sub-sections.
2) A section needs a title and can no longer
exist without one. The first line
of the textfiles contains now the title
and will be inserted by mkref into the xml file.
todo: switch from xmlto to dblatex for the pdf generation
and re-enable it in the makefile.
