Source-Changes archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

New sentence, new line (was: CVS commit: src/lib/libc/gen)



On Sunday, 23 November 2003 at  9:52:58 -0700, M. Warner Losh wrote:
> In message: <E498BA74-1D8A-11D8-BE48-000A957650EC%wasabisystems.com@localhost>
>             Jason Thorpe <thorpej%wasabisystems.com@localhost> writes:
>> On Nov 22, 2003, at 11:27 PM, John Hawkinson wrote:
>>
>>> You really need to put this in our style guide (and get
>>> core/technical-exec buyoff) if you want developers to
>>> enforce it.
>>
>> IIRC, "new sentence, new line" has always been a requirement for *roff
>> to process text correctly.
>
> That's what I was told when I asked why FreeBSD enforced such a rule.
> Maybe things have changed in roff-land since then...

Hmm.  What I heard in the FreeBSD doc project that it was to minimize
repo bloat due to minor modifications to the text.  That makes about
as much sense as the explanation you heard.  In any case, I've been
using *roff for document preparation for over ten years, and I've
never seen any problems with sentence spacing.  And no, I'm not
picking on the messenger, just observing.

On Sunday, 23 November 2003 at 12:22:51 -0500, John Hawkinson wrote:
>
> It ("new sentence, new line") feels like a sick joke writing text for
> manpages.
>
> I fear a "rule" like this discourages people from writing text with
> any verbosity. That's part of why I dislike it so strongly.

I don't follow this.  My reason for disliking it is that it's an
artificial obfuscation.  Normally text is written in roughly
even-length lines, and this rule breaks it.  But I didn't complain in
the FreeBSD project, and I'm not complaining here.

Greg
--
See complete headers for address and phone numbers.

Attachment: pgpUE8_9PtuL4.pgp
Description: PGP signature



Home | Main Index | Thread Index | Old Index