From owner-cvs-all Sun Aug 5 6:21:33 2001 Delivered-To: cvs-all@freebsd.org Received: from axl.seasidesoftware.co.za (axl.seasidesoftware.co.za [196.31.7.201]) by hub.freebsd.org (Postfix) with ESMTP id E3D9137B401; Sun, 5 Aug 2001 06:21:26 -0700 (PDT) (envelope-from sheldonh@starjuice.net) Received: from sheldonh (helo=axl.seasidesoftware.co.za) by axl.seasidesoftware.co.za with local-esmtp (Exim 3.31 #1) id 15TNrY-000LS2-00; Sun, 05 Aug 2001 15:22:36 +0200 From: Sheldon Hearn To: Dima Dorfman Cc: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/usr.sbin/pwd_mkdb pwd_mkdb.8 In-reply-to: Your message of "Sat, 04 Aug 2001 15:11:08 MST." <200108042211.f74MB8e90328@freefall.freebsd.org> Date: Sun, 05 Aug 2001 15:22:36 +0200 Message-ID: <82461.997017756@axl.seasidesoftware.co.za> Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG On Sat, 04 Aug 2001 15:11:08 MST, Dima Dorfman wrote: > Modified files: > usr.sbin/pwd_mkdb pwd_mkdb.8 > Log: > It's bad enough to capitalize the name of the executable at the > beginning of the sentence, but at the very least it shouldn't be done > in the middle of a sentence! FYI, it shouldn't be done at the beginning of the sentence either. The concensus I last saw accepted (albeit with grumbles from some) is: 1) Don't start a sentence with .Nm unless the alternatives make for uncomfortable or unnatural reading. 2) When a sentence starts with .Nm, no special capitalization should be enforced. Usually, this means no argument to .Nm at all. Ciao, Sheldon. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message