From owner-svn-src-head@FreeBSD.ORG  Fri May 29 09:25:36 2009
Return-Path: <owner-svn-src-head@FreeBSD.ORG>
Delivered-To: svn-src-head@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id CFC2A106564A;
	Fri, 29 May 2009 09:25:36 +0000 (UTC) (envelope-from bde@zeta.org.au)
Received: from mail04.syd.optusnet.com.au (mail04.syd.optusnet.com.au
	[211.29.132.185])
	by mx1.freebsd.org (Postfix) with ESMTP id 4C6628FC1B;
	Fri, 29 May 2009 09:25:36 +0000 (UTC) (envelope-from bde@zeta.org.au)
Received: from c122-106-151-9.carlnfd1.nsw.optusnet.com.au
	(c122-106-151-9.carlnfd1.nsw.optusnet.com.au [122.106.151.9])
	by mail04.syd.optusnet.com.au (8.13.1/8.13.1) with ESMTP id
	n4T9PQwG020241
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO);
	Fri, 29 May 2009 19:25:28 +1000
Date: Fri, 29 May 2009 19:25:26 +1000 (EST)
From: Bruce Evans <bde@zeta.org.au>
X-X-Sender: bde@delplex.bde.org
To: "Bruce A. Mah" <bmah@FreeBSD.org>
In-Reply-To: <4A1EC5FA.50601@freebsd.org>
Message-ID: <20090529192129.B5886@delplex.bde.org>
References: <200905271636.n4RGasNe003922@svn.freebsd.org>
	<47d0403c0905271005t7f57f9b9h3d0721bbb1fbedc2@mail.gmail.com>
	<86tz35qlrw.fsf@ds4.des.no> <4A1EC5FA.50601@freebsd.org>
MIME-Version: 1.0
Content-Type: MULTIPART/MIXED; BOUNDARY="0-1397947210-1243589126=:5886"
Cc: src-committers@FreeBSD.org, svn-src-all@FreeBSD.org,
	Ben Kaduk <minimarmot@gmail.com>,
	Zachary Loafman <zml@FreeBSD.org>, svn-src-head@FreeBSD.org,
	=?UTF-8?B?RGFnLUVybGluZyBTbcO4cmdyYXY=?= <des@des.no>
Subject: Re: svn commit: r192908 - in head: share/man/man9 sys/conf sys/kern
 sys/sys
X-BeenThere: svn-src-head@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: SVN commit messages for the src tree for head/-current
	<svn-src-head.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-head>,
	<mailto:svn-src-head-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-head>
List-Post: <mailto:svn-src-head@freebsd.org>
List-Help: <mailto:svn-src-head-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-head>,
	<mailto:svn-src-head-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 29 May 2009 09:25:37 -0000

  This message is in MIME format.  The first part should be readable text,
  while the remaining parts are likely unreadable without MIME-aware tools.

--0-1397947210-1243589126=:5886
Content-Type: TEXT/PLAIN; charset=X-UNKNOWN; format=flowed
Content-Transfer-Encoding: QUOTED-PRINTABLE

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

> If memory serves me right, Dag-Erling Sm=C3=B8rgrav wrote:
>> Ben Kaduk <minimarmot@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
--0-1397947210-1243589126=:5886--