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-head/attachments/20090528/eaedced6/signature.pgp
More information about the svn-src-head
mailing list