Re: [Firebird-docs] New potential doc writer

[Paul V. <pa...@vi...>]

Hi Norman,

> I've managed to add my GSEC document to the firebirddocs.xml. I had
> a few problems in PDF generation if it as added as a book, but I
> reworked it as an article, and all is well.

It should work equally well as a <book>. BTW, as you probably noticed,
"build pdf" results in One Big Book containing all our documentation,
which is stupid. So for the PDF generation, we have to resort to a
little trick:

- Open manual/src/docs/fo.xsl and find this line:
  <xsl:param name="rootid" select="''"/>

- Fill in the topmost DocBook id of the document you want to produce.
  For instance, if the id is "cltools", change the line to:
  <xsl:param name="rootid" select="'cltools'"/>

- Now if you issue a "build pdf", the PDF file will only contain the
  cltools document. Note: it will still be called "firebirddocs.pdf"
  but of course you can rename it.

In the meantime I've committed some more PDF rendering improvements to
CVS. It may be worth updating your local copy of the manual tree.

Please let us know if/when you've got something to show! :-)


Greetings,
Paul Vinkenoog