From owner-freebsd-doc@FreeBSD.ORG  Fri Oct 14 04:36:32 2011
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 9AD71106566B
	for <freebsd-doc@freebsd.org>; Fri, 14 Oct 2011 04:36:32 +0000 (UTC)
	(envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
	by mx1.freebsd.org (Postfix) with ESMTP id 3C8B28FC13
	for <freebsd-doc@freebsd.org>; Fri, 14 Oct 2011 04:36:31 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
	by wonkity.com (8.14.5/8.14.5) with ESMTP id p9E4Dj0i051221;
	Thu, 13 Oct 2011 22:13:45 -0600 (MDT)
	(envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
	by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id p9E4DjkZ051218;
	Thu, 13 Oct 2011 22:13:45 -0600 (MDT)
	(envelope-from wblock@wonkity.com)
Date: Thu, 13 Oct 2011 22:13:45 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Benjamin Kaduk <kaduk@MIT.EDU>
In-Reply-To: <alpine.GSO.1.10.1110132355240.882@multics.mit.edu>
Message-ID: <alpine.BSF.2.00.1110132212210.51180@wonkity.com>
References: <201110121030.p9CAUDxd032245@freefall.freebsd.org>
	<alpine.GSO.1.10.1110132355240.882@multics.mit.edu>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7
	(wonkity.com [127.0.0.1]); Thu, 13 Oct 2011 22:13:45 -0600 (MDT)
Cc: Niclas Zeising <niclas.zeising@gmail.com>, freebsd-doc@freebsd.org
Subject: Re: docs/160696: style(9) should be mentioned in the devs&#39;
 handbook
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 14 Oct 2011 04:36:32 -0000

On Fri, 14 Oct 2011, Benjamin Kaduk wrote:

> The overall paragraph feels a bit odd, though; maybe like it's written in a 
> more informal style than I would expect?  A more standard dry, technical 
> writing version might be:
> %%%%%%%%%%
> <para>When working in a large codebase such as the &os; source, it is 
> important to adhere to a common coding style.  This provides uniformity
                ^^^^^^
"conform" might be better here.