From owner-svn-src-head@FreeBSD.ORG Thu May 28 01:47:46 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 5ABF61065675; Thu, 28 May 2009 01:47:46 +0000 (UTC) (envelope-from zml@FreeBSD.org) Received: from seaxch10.isilon.com (seaxch10.isilon.com [74.85.160.26]) by mx1.freebsd.org (Postfix) with ESMTP id 35EEA8FC2F; Thu, 28 May 2009 01:47:45 +0000 (UTC) (envelope-from zml@FreeBSD.org) Received: from famine.isilon.com ([10.54.190.95]) by seaxch10.isilon.com with Microsoft SMTPSVC(6.0.3790.1830); Wed, 27 May 2009 18:47:26 -0700 Received: from zloafman by famine.isilon.com with local (Exim 4.69) (envelope-from ) id 1M9UiM-0002RN-D6; Wed, 27 May 2009 18:47:26 -0700 Date: Wed, 27 May 2009 18:47:26 -0700 From: Zachary Loafman To: Ben Kaduk Message-ID: <20090528014726.GG3704@isilon.com> References: <200905271636.n4RGasNe003922@svn.freebsd.org> <47d0403c0905271005t7f57f9b9h3d0721bbb1fbedc2@mail.gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <47d0403c0905271005t7f57f9b9h3d0721bbb1fbedc2@mail.gmail.com> User-Agent: Mutt/1.5.18 (2008-05-17) X-OriginalArrivalTime: 28 May 2009 01:47:26.0756 (UTC) FILETIME=[40F16640:01C9DF36] Cc: svn-src-head@freebsd.org, svn-src-all@freebsd.org, src-committers@freebsd.org, dfr@freebsd.org Subject: 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 01:47:47 -0000 On Wed, May 27, 2009 at 10:05:44AM -0700, Ben Kaduk wrote: > 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.) Ben - Thanks for the pedantry! I've attached a patch that should address your issues. (Doug, please review as mentor when you get a chance.) This is my first man page, so I apologize for the style violations. I fixed all the new sentence instances I could find, but I left the "e.g." and "i.e." instances untouched. That seems like it would suffer from the same issue, but I left them alone for now. Is there a style(9) equivalent for man pages? I hunted for a bit, but "man -k style" returned only style(9) and style.Makefile(9). -- Zach Loafman | Staff Engineer | Isilon Systems