Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 27 May 2009 18:47:26 -0700
From:      Zachary Loafman <zml@FreeBSD.org>
To:        Ben Kaduk <minimarmot@gmail.com>
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 ...)
Message-ID:  <20090528014726.GG3704@isilon.com>
In-Reply-To: <47d0403c0905271005t7f57f9b9h3d0721bbb1fbedc2@mail.gmail.com>
References:  <200905271636.n4RGasNe003922@svn.freebsd.org> <47d0403c0905271005t7f57f9b9h3d0721bbb1fbedc2@mail.gmail.com>

next in thread | previous in thread | raw e-mail | index | archive | help
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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20090528014726.GG3704>