From owner-cvs-all Thu Nov 11 8: 1:23 1999 Delivered-To: cvs-all@freebsd.org Received: from yana.lemis.com (yana.lemis.com [192.109.197.140]) by hub.freebsd.org (Postfix) with ESMTP id C4EE714CA7; Thu, 11 Nov 1999 08:01:08 -0800 (PST) (envelope-from grog@mojave.sitaranetworks.com) Received: from mojave.sitaranetworks.com (mojave.sitaranetworks.com [199.103.141.157]) by yana.lemis.com (8.8.8/8.8.8) with ESMTP id CAA13999; Fri, 12 Nov 1999 02:30:50 +1030 (CST) (envelope-from grog@mojave.sitaranetworks.com) Message-ID: <19991111110005.27784@mojave.sitaranetworks.com> Date: Thu, 11 Nov 1999 11:00:05 -0500 From: Greg Lehey To: Bruce Evans , Sheldon Hearn Cc: obrien@NUXI.com, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/contrib/grep/doc grep.1 Reply-To: Greg Lehey References: <83676.942312329@axl.noc.iafrica.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii In-Reply-To: ; from Bruce Evans on Fri, Nov 12, 1999 at 12:03:02AM +1100 Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk 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