From owner-svn-src-head@FreeBSD.ORG Thu May 28 06:14:03 2009 Return-Path: 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 A18CA106566C; Thu, 28 May 2009 06:14:03 +0000 (UTC) (envelope-from kientzle@freebsd.org) Received: from kientzle.com (kientzle.com [66.166.149.50]) by mx1.freebsd.org (Postfix) with ESMTP id 5A01C8FC15; Thu, 28 May 2009 06:14:03 +0000 (UTC) (envelope-from kientzle@freebsd.org) Received: (from root@localhost) by kientzle.com (8.14.3/8.14.3) id n4S5p3qN024519; Wed, 27 May 2009 22:51:03 -0700 (PDT) (envelope-from kientzle@freebsd.org) Received: from dark.x.kientzle.com (fw2.kientzle.com [10.123.1.2]) by kientzle.com with SMTP id 9chw6sf4j6q4ib6nz7wq7twf5e; Wed, 27 May 2009 22:51:02 -0700 (PDT) (envelope-from kientzle@freebsd.org) Message-ID: <4A1E2646.6040807@freebsd.org> Date: Wed, 27 May 2009 22:51:02 -0700 From: Tim Kientzle User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.8.1.21) Gecko/20090409 SeaMonkey/1.1.15 MIME-Version: 1.0 To: Benjamin Kaduk References: <200905271636.n4RGasNe003922@svn.freebsd.org> <47d0403c0905271005t7f57f9b9h3d0721bbb1fbedc2@mail.gmail.com> <20090528014726.GG3704@isilon.com> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: dfr@freebsd.org, src-committers@freebsd.org, svn-src-all@freebsd.org, Ben Kaduk , Zachary Loafman , svn-src-head@freebsd.org Subject: Re: Review: fail(9) style/grammar (was Re: svn commit: r192908 ...) 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 28 May 2009 06:14:04 -0000 Benjamin Kaduk wrote: > ... I think that the new > sentence-->new line may also relate to having two spaces > between sentences -- I think that (e.g.) "e.g." should be okay. It's mostly about keeping diffs easy to read. Changes that add, remove, or edit a single sentence are pretty common. If every sentence starts on a new line, then such changes only affect a couple of lines. Nroff will wrap paragraphs for you, so this doesn't affect the formatted output. The alternative is usually to word-wrap blocks of text in your editor. In that case, editing even one word (and then re-wrapping) can affect the rest of the paragraph. This causes many-line diffs that are a lot harder to read. So the rule is "every sentence starts on a new line". In particular, "e.g.," and "i.e." never start or end a sentence, so they're unaffected by this rule. However, I personally try to avoid Latin abbreviations such as "e.g." and "i.e." in my own writing. I strongly prefer "for example" to "e.g.". For "i.e.", I generally find that it can be replaced with a sentence break, semicolon, or even a comma splice. Opinions differ, of course. Tim