Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 14 Nov 1999 22:04:10 -0500 (EST)
From:      Garrett Wollman <wollman@khavrinen.lcs.mit.edu>
To:        Mike Pritchard <mpp@mppsystems.com>
Cc:        cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org
Subject:   Re: cvs commit: src/contrib/grep/doc grep.1
Message-ID:  <199911150304.WAA04016@khavrinen.lcs.mit.edu>
In-Reply-To: <19991112051528.A62006@mppsystems.com>
References:  <19991111235932.A62263@catkin.nothing-going-on.org> <6216.942392728@axl.noc.iafrica.com> <19991112051528.A62006@mppsystems.com>

next in thread | previous in thread | raw e-mail | index | archive | help
<<On Fri, 12 Nov 1999 05:15:28 -0600, Mike Pritchard <mpp@mppsystems.com> said:

> On Fri, Nov 12, 1999 at 09:45:28AM +0200, Sheldon Hearn wrote:
> The _name_ command/function/utility/gizmo blah blah blah...

> instead of:

> _Name_ command/func/utility/gizmo blah blah blah.

The former is what is universally required in standards documents,
where ambiguity is unacceptable.  (I attended the standards BOF at
LISA last week.  The next version of POSIX will take SUSv2 as a base
document, and much of the committee's time has been taken up with
translating the TOG documents into the IEEE dialect of Standardese.)

The latter is what the Official Berkeley manual page style used, which
is why we have so many examples of it -- when the manual pages were
rewritten to use mdoc(7), all sentences were forcibly capitalized.

-GAWollman

--
Garrett A. Wollman   | O Siem / We are all family / O Siem / We're all the same
wollman@lcs.mit.edu  | O Siem / The fires of freedom 
Opinions not those of| Dance in the burning flame
MIT, LCS, CRS, or NSA|                     - Susan Aglukark and Chad Irschick


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message




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