[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: Reformat help text source, creating some long source lines

From: Branko Čibej <brane_at_xbc.nu>
Date: 2005-11-28 02:42:14 CET

Julian Foad wrote:
> kfogel@collab.net wrote:
>> Julian Foad <julianfoad@btopenworld.com> writes:
>>
>>> May I re-format the source lines of the built-in help text such that
>>> output lines are not broken over two source lines? The present layout
>>> is so awkward that I feel it is stifling maintenance of that text.
>>
>> I'm not opposed -- your argument makes sense to me. Can you update
>> www/hacking.html in the obvious way if you do this, though?
>
> Thanks - OK - done - r17522.
I wish I'd seen this thread before...

Looking at this from the point of view of the typesetting world, there's
no reason to introduce long lines in the source. Within running (roman)
text, the optimal line length for easy reading is about 68 glyphs;
anything wider makes it harder for the eye to skip to the next line.
(And that's why I'll never understand those people who expand their Web
browser windows across the whole screen, then get a crick in their neck
trying to follow the text.)

What I'm getting at is: shorten the displayed text lines, don't widen
the source.

-- Brane

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Mon Nov 28 02:42:49 2005

This is an archived mail posted to the Subversion Dev mailing list.

This site is subject to the Apache Privacy Policy and the Apache Public Forum Archive Policy.