[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: Julian Foad <julianfoad_at_btopenworld.com>
Date: 2005-11-27 01:28:58 CET

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.

Max Bowsher wrote:
> Doing this does, of course, mean that as soon as you put the text into a
> line-wrapping mailer, it goes wonky, but overall, I agree with Julian's
> point about stifling maintenance.
>
> I have a slight extension of the proposal:
>
> If we limit our output text to 76 characters of width, and decide to
> permit long multiline text blocks to be totally *non-indented*, then we
> will avoid the need for the extra line breaks in the source which are
> the cause of the awkwardness, whilst still keeping lines within 80
> characters:

That's certainly another possibility but, as well as slightly restricting the
output, the indentation would be ugly for everyone all of the time.

- Julian

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Sun Nov 27 01:29:47 2005

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