From owner-freebsd-doc@FreeBSD.ORG Sat Oct 15 22:53:09 2011 Return-Path: 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 2AB8A106566C for ; Sat, 15 Oct 2011 22:53:09 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-1.mit.edu (DMZ-MAILSEC-SCANNER-1.MIT.EDU [18.9.25.12]) by mx1.freebsd.org (Postfix) with ESMTP id B4A8B8FC08 for ; Sat, 15 Oct 2011 22:53:08 +0000 (UTC) X-AuditID: 1209190c-b7fd26d0000008df-4e-4e9a0ed389c8 Received: from mailhub-auth-2.mit.edu ( [18.7.62.36]) by dmz-mailsec-scanner-1.mit.edu (Symantec Messaging Gateway) with SMTP id 6C.C9.02271.3DE0A9E4; Sat, 15 Oct 2011 18:53:07 -0400 (EDT) Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id p9FMr7Yk029787; Sat, 15 Oct 2011 18:53:07 -0400 Received: from multics.mit.edu (MULTICS.MIT.EDU [18.187.1.73]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id p9FMr543022035 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sat, 15 Oct 2011 18:53:06 -0400 (EDT) Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id p9FMr4bf014706; Sat, 15 Oct 2011 18:53:04 -0400 (EDT) Date: Sat, 15 Oct 2011 18:53:03 -0400 (EDT) From: Benjamin Kaduk To: Garrett Cooper In-Reply-To: Message-ID: References: <201110121030.p9CAUDxd032245@freefall.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: MULTIPART/MIXED; BOUNDARY="-559023410-1032669857-1318719122=:882" Content-ID: X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFjrEKsWRmVeSWpSXmKPExsUixG6nonuZb5afQfddC4tTZ7pYLd70HWa0 +HXKw2L992WMDiweMz7NZ/HYOesuu8eRjkeMAcxRXDYpqTmZZalF+nYJXBkdC/qYC+7xVRx9 ZdXA2M/TxcjJISFgItG2ZQsjhC0mceHeerYuRi4OIYF9jBILL+9hhnA2MEr8eHeeHcI5wCTx 5PUyqLIGRomZr3eygPSzCGhLXLzwgx3EZhNQkZj5ZiMbiC0ioC5x6cAWoDgHB7NAkcSfD6og YWGBIIlJyxaBlXAKBEos+3QczOYVsJdYP+MZ2EghgUdAy+brgNiiAjoSq/dPYYGoEZQ4OfMJ mM0s4C+x7/YeVgjbXmJR2wa2CYxCs5CUzUJSNgtJGYRtI3F301tGCFtb4v7NNjaYmsPLFzAu YGRbxSibklulm5uYmVOcmqxbnJyYl5dapGuol5tZopeaUrqJERQ9nJI8OxjfHFQ6xCjAwajE wzspa4afEGtiWXFl7iFGSQ4mJVHeFGDsCfEl5adUZiQWZ8QXleakFh9ilOBgVhLhzcya6SfE m5JYWZValA+TkuZgURLnPbjDwU9IID2xJDU7NbUgtQgmK8PBoSTBqw8yVLAoNT21Ii0zpwQh zcTBCTKcB2j4Vl6gGt7igsTc4sx0iPwpRl2OuVMPnWQUYsnLz0uVEue1BhkkAFKUUZoHNweW 9F4xigO9JcyrBVLFA0yYcJNeAS1hAlrySgnkg+KSRISUVANjgYH6ftYjDxmYv5tPv/lX+Nms wI4fnauyNKQUZspfil+s5f+u4dW0Ws8162XNre+bLln67ojDX/mjl14cFIr+/lJla7XEv/bD 0k9uxp/NXijsaHX+69nbm/PCf7wReHvqwjxxo2V3boSX8UfcWcEuYifyZ8nf44vP9TBsCFjG VPzoib+3VNCJMiWW4oxEQy3mouJEAP7xJCFVAwAA Cc: Niclas Zeising , freebsd-doc@freebsd.org Subject: Re: docs/160696: style(9) should be mentioned in the devs' handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 15 Oct 2011 22:53:09 -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. ---559023410-1032669857-1318719122=:882 Content-Type: TEXT/PLAIN; CHARSET=ISO-8859-15; FORMAT=flowed Content-Transfer-Encoding: QUOTED-PRINTABLE Content-ID: On Fri, 14 Oct 2011, Garrett Cooper wrote: > On Thu, Oct 13, 2011 at 11:37 PM, Warren Block wrote= : >> On Thu, 13 Oct 2011, Garrett Cooper wrote: >> >>> On Thu, Oct 13, 2011 at 9:13 PM, Warren Block wrot= e: >>>> >>>> On Fri, 14 Oct 2011, Benjamin Kaduk wrote: >>>> >>>>> The overall paragraph feels a bit odd, though; maybe like it's writte= n >>>>> in >>>>> a more informal style than I would expect? =A0A more standard dry, >>>>> technical >>>>> writing version might be: >>>>> %%%%%%%%%% >>>>> When working in a large codebase such as the &os; source, it is >>>>> important to adhere to a common coding style. =A0This provides unifor= mity >>>> >>>> =A0 =A0 =A0 =A0 =A0 =A0 =A0 ^^^^^^ >>>> "conform" might be better here. >>> >>> I'm usually not touchy feely about wording like this, but unless the >>> rest of the document is worded in such a standoffish / cold manner, I >>> would just keep things polite and neutral. "Conform" sounds really >>> pushy and "When working in a..." sounds condescending in my opinion. >> >> Here's a rewrite: >> >> Consistent coding style is extremely important, particularly with >> =A0large projects like &os;. =A0Code should follow the &os; coding style= s >> =A0described in &man.style.9;, and &man.style.Makefile.5;. > > Sounds ok. No arguments, here. (Well, except for Garrett's mailer's mangling of the whitespace ...) -Ben ---559023410-1032669857-1318719122=:882--