Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 23 Jan 2001 22:42:41 +0000
From:      Nik Clayton <nik@freebsd.org>
To:        Ben Smithurst <csxbcs@comp.leeds.ac.uk>, grog@freebsd.org
Cc:        Alexey Zelkin <phantom@ark.cris.net>, Ruslan Ermilov <ru@FreeBSD.org>, Sheldon Hearn <sheldonh@FreeBSD.org>, Mike Pritchard <mpp@FreeBSD.org>, doc@FreeBSD.org
Subject:   Re: mdoc(7) questionnaire (was: Re: trailing dot in .Nd)
Message-ID:  <20010123224241.A1974@canyon.nothing-going-on.org>
In-Reply-To: <20010123162819.C29189@comp.leeds.ac.uk>; from csxbcs@comp.leeds.ac.uk on Tue, Jan 23, 2001 at 04:28:19PM %2B0000
References:  <20010122175432.A31943@sunbay.com> <20010122185304.B25101@comp.leeds.ac.uk> <20010123101530.A98532@sunbay.com> <20010123164227.A4978@ark.cris.net> <20010123162819.C29189@comp.leeds.ac.uk>

next in thread | previous in thread | raw e-mail | index | archive | help
I've explicitly pulled Greg Lehey in to this.

On Tue, Jan 23, 2001 at 04:28:19PM +0000, Ben Smithurst wrote:
> Alexey Zelkin wrote:
> 
> >> 2.  Should we consistently change all occurrences of ``.Nm Foo'' to
> >>     ``.Nm foo'' where the command name is actually ``foo''?  (YES, NO)
> > 
> > Yes, of course, but it just should be changed to construction like
> > 
> > The command/utility/etc
> > .Nm
> 
> I disagree with this, putting "the ... command" around something is just
> unnecessary IMO.  But perhaps grammatical correctness means more to some
> people than it does to me. :-)

FWIW, that's my opinion as well.  However, out of the depths of my
somewhat rusty memory I think I recall Greg Lehey having some compelling
reasons for doing the opposite (i.e., what Alexey is suggesting).  I
can't for the life of me remember what they were though, hence the cc:,
in the hope that Greg can remind us.

N
-- 
Internet connection, $19.95 a month.  Computer, $799.95.  Modem, $149.95.
Telephone line, $24.95 a month.  Software, free.  USENET transmission,
hundreds if not thousands of dollars.  Thinking before posting, priceless.
Somethings in life you can't buy.  For everything else, there's MasterCard.
  -- Graham Reed, in the Scary Devil Monastery


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




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