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

Bruce A. Mah bmah at freebsd.org
Thu May 28 17:12:31 UTC 2009


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.

Bruce.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 257 bytes
Desc: OpenPGP digital signature
Url : http://lists.freebsd.org/pipermail/svn-src-all/attachments/20090528/eaedced6/signature.pgp


More information about the svn-src-all mailing list