svn commit: r192908 - in head: share/man/man9 sys/conf sys/kern sys/sys

[Bruce Evans]

On Thu, 28 May 2009, Bruce A. Mah wrote:

> If memory serves me right, Dag-Erling Smørgrav wrote:
>> Ben Kaduk <minimarmot at gmail.com> writes:
>>> Our man page style says that new sentences should start on new lines.
>>> (Since the '.' character is used for defining macros, and sometimes
>>> the processor can get confused.)
>>
>> That's not the reason - the reason is that it makes diffs easier to
>> read, which in turn makes it easier for our translators to keep the
>> translated man pages in sync.
>
> My understanding is that we do this to let groff manage the whitespace
> between sentences.  But your comment regarding diffs is quite valid.

It is both of these, but letting groff manage the sentence breaks is more
important since it is related to the output style.

Bruce