Re: CVS docs PDF patch

[Bart Veer <bartv at ecoscentric dot com>]

>>>>> "Iztok" == Iztok Zupet <iztok.zupet@vsr.si> writes:

    Iztok> This is a simple patch to the stylesheet affecting only the
    Iztok> pdf output. It eliminates most of the /hbox (page with)
    Iztok> overflows in program output and code snippets.

    Iztok> Sorry, this seems the only parameter that the
    Iztok> display-verbatim function in the print docbook stylesheet
    Iztok> takes. It does not seem to take care for WIDTH attribute as
    Iztok> the one in the html stylesheet takes.

There may be another approach, not necessarily better. The current
stylesheet has:

  ;; Set the paper parameters as per other eCos documentation
  (define %page-width%   7.5in)
  (define %page-height%  10.2in)
  (define %left-margin%  0.75in)
  (define %right-margin% 0.75in)

Those dimensions date from quite some time ago. IIRC they corresponded
to conventions within the Cygnus documentation department at the time,
and those manuals were fairly small. Offhand I cannot think of a good
reason for sticking to those conventions, so we could switch to a
larger page size, e.g. A4 or US letter. That would add somewhere
between 0.75in and 1in to the width, possibly enough to avoid hbox
problems. It might still be desirable to adjust the verbatim font
size, but perhaps by a lesser amount.

Of course this assumes that pdfjadetex actually uses those parameters.

I have no particular preferences in this area, just thought I would
point out an alternative.

Bart