svn commit: r192908 - in head: share/man/man9 sys/conf sys/kern
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.
More information about the svn-src-all