Re: code example wrapping - Mailing list pgsql-docs

From Erik Rijkers
Subject Re: code example wrapping
Date
Msg-id bd0be715c13a013438ffd986b29aa295.squirrel@webmail.xs4all.nl
Whole thread Raw
In response to Re: code example wrapping  (Tom Lane <tgl@sss.pgh.pa.us>)
Responses Re: code example wrapping
List pgsql-docs
On Mon, April 5, 2010 18:18, Tom Lane wrote:
> "Erik Rijkers" <er@xs4all.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




pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: code example wrapping
Next
From: Peter Eisentraut
Date:
Subject: Re: Documentation and explanatory diagrams