In "comedilib.ent", Add an XML entity 'comedilib_version' expanding to
the Comedilib version '0.10.0'. This is hard-edited in rather than set
dynamically. Setting it dynamically would be nice but producing it from
an AC_OUTPUT() file isn't all that nice as it would end up in the
'build' tree and we'd some ugly 'make' rule to copy it to the 'source'
tree. For now, just edit it manually as required. At least having it
as an entity means it only needs to be set in a single documentation
file!
In "comedilib.xml", change the subtitle to mention Comedilib and the
version number, using the comediliv_version entity.
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.
