Date: Fri, 12 Nov 1999 00:03:02 +1100 (EST) From: Bruce Evans <bde@zeta.org.au> To: Sheldon Hearn <sheldonh@uunet.co.za> Cc: obrien@NUXI.com, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/contrib/grep/doc grep.1 Message-ID: <Pine.BSF.4.10.9911112341560.15232-100000@alphplex.bde.org> In-Reply-To: <83676.942312329@axl.noc.iafrica.com>
next in thread | previous in thread | raw e-mail | index | archive | help
> Having looked at Joseph's arguments in favour of your war, I shall ally
> with you. I would like to see more use of sentence shuffling and less
> use of capitalization where possible.
We often use the ugly standardese "The foo command" instead of "Foo".
E.g., in cat.1, we use
The cat utility ...
The cat utility ...
A cat command ...
... cat(1)
but we never use plain `cat' in English sentences in cat.1. The V7 man
page is less stilted. Its DESCRIPTION section begins with
Cat reads ...
where `Cat' is in italics.
For functions, "The foo() function" is even uglier, since `()' says that
it's a function.
Bruce
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?Pine.BSF.4.10.9911112341560.15232-100000>