Subject: Re: code example wrapping
From: Peter Eisentraut <peter_e@gmx.net>
To: Erik Rijkers <er@xs4all.nl>
Cc: Tom Lane <tgl@sss.pgh.pa.us>, pgsql-docs@postgresql.org
In-Reply-To: <bd0be715c13a013438ffd986b29aa295.squirrel@webmail.xs4all.nl>
References: <2dadc3297b424c7540eb0fa70d418156.squirrel@webmail.xs4all.nl>
	<23091.1270484314@sss.pgh.pa.us>
	<bd0be715c13a013438ffd986b29aa295.squirrel@webmail.xs4all.nl>
Content-Type: text/plain; charset="UTF-8"
Date: Mon, 05 Apr 2010 20:29:31 +0300
Message-ID: <1270488571.18421.6.camel@vanquo.pezone.net>
Mime-Version: 1.0
Content-Transfer-Encoding: 8bit

On mån, 2010-04-05 at 18:30 +0200, Erik Rijkers wrote:
> 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.

Sure, makes sense.  Lines much longer than 60-80 characters are probably
not too readable in any format.