From: | "Erik Rijkers" <er(at)xs4all(dot)nl> |
---|---|
To: | "Tom Lane" <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
Cc: | pgsql-docs(at)postgresql(dot)org |
Subject: | Re: code example wrapping |
Date: | 2010-04-05 16:30:26 |
Message-ID: | bd0be715c13a013438ffd986b29aa295.squirrel@webmail.xs4all.nl |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
On Mon, April 5, 2010 18:18, Tom Lane wrote:
> "Erik Rijkers" <er(at)xs4all(dot)nl> writes:
>> The manual has quite a few cases in the code-examples where, in the pdf version, there isn't
>> enough width to show the whole line. Unfortunately, the rest of the line is then simply cut
>> off,
>> making the example 'invalid' (while reading, but also for copy-paste).
>
>> I would like to reformat (only) those cases so that the text is completely readable on the pdf
>> page.
> Exactly what width do you intend to wrap to, and how did you arrive at
> the number?
>
I want to manually reformat, rather than automatically wrap to some fixed width.
The width would be determined by readability of the .pdf versions (-A4, -US). Maybe I should
check other formats at the same time?
It looks like less than 60 or 80 would already solve most of the problem-cases. Obviously, the
actual split should be determined by the syntax of the example.
Erik Rijkers
From | Date | Subject | |
---|---|---|---|
Next Message | Peter Eisentraut | 2010-04-05 17:27:38 | Re: Documentation and explanatory diagrams |
Previous Message | Tom Lane | 2010-04-05 16:18:34 | Re: code example wrapping |