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

Bruce Evans bde at zeta.org.au
Fri May 29 09:25:37 UTC 2009


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


More information about the svn-src-all mailing list