Date: Thu, 11 Nov 1999 11:00:05 -0500 From: Greg Lehey <grog@mojave.sitaranetworks.com> To: Bruce Evans <bde@zeta.org.au>, 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: <19991111110005.27784@mojave.sitaranetworks.com> In-Reply-To: <Pine.BSF.4.10.9911112341560.15232-100000@alphplex.bde.org>; from Bruce Evans on Fri, Nov 12, 1999 at 12:03:02AM %2B1100 References: <83676.942312329@axl.noc.iafrica.com> <Pine.BSF.4.10.9911112341560.15232-100000@alphplex.bde.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Friday, 12 November 1999 at 0:03:02 +1100, Bruce Evans wrote: >> 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. Agreed, these euphemisms are ugly. But what are you saying about the matter at hand? Should we capitalize function and command names at the beginning of the sentence or not? I'm in favour of spelling them correctly: case sensitivity should override English spelling conventions. Greg -- Finger grog@lemis.com for PGP public key See complete headers for address and phone numbers 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?19991111110005.27784>