Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 05 Aug 2001 15:22:36 +0200
From:      Sheldon Hearn <sheldonh@starjuice.net>
To:        Dima Dorfman <dd@FreeBSD.org>
Cc:        cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org
Subject:   Re: cvs commit: src/usr.sbin/pwd_mkdb pwd_mkdb.8 
Message-ID:  <82461.997017756@axl.seasidesoftware.co.za>
In-Reply-To: Your message of "Sat, 04 Aug 2001 15:11:08 MST." <200108042211.f74MB8e90328@freefall.freebsd.org> 

next in thread | previous in thread | raw e-mail | index | archive | help


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




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