This is the mail archive of the ecos-patches@sources.redhat.com mailing list for the eCos project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: CVS docs PDF patch


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

    Iztok> On Tuesday 29 October 2002 22:36, Bart Veer wrote:
    >> ;; 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.
    >> 

    Iztok> Pdfjadetex indeed produces the PDF of requested size
    Iztok> (7.46x10.16inch) which does not fit anywhere, except onto a
    Iztok> custom size printed book. I was meaning to point that out
    Iztok> in future.

    Iztok> Besides:
    Iztok>  since the PDF on Windows doesn't seem to be able of
    Iztok> producing high quality printable output (depends on the
    Iztok> printer driver, I.E. up to now I haven't been able to print
    Iztok> a 100 page PDF datasheet complete to our Panasonic printer,
    Iztok> I had to use Linux to do that), I suggest that we define 3
    Iztok> possible targets with 3 separate stylesheets, that is HTML
    Iztok> (as it is), PDF (generated for viewing in a reader) and
    Iztok> postscript (generated for actual printing).

It seems a little bit strange to generate HTML for online reading and
a separate PDF for online reading, and some users may get confused if
there are two PDF's for each document. But if you think the
differences between the two PDF's are worthwhile, I have no objection.

Bart


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]