From owner-freebsd-doc Wed Jan 24 3:31:34 2001 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (unknown [194.128.198.234]) by hub.freebsd.org (Postfix) with ESMTP id C421F37B6A4; Wed, 24 Jan 2001 03:31:15 -0800 (PST) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.1/8.11.1) id f0NMgf601997; Tue, 23 Jan 2001 22:42:41 GMT (envelope-from nik) Date: Tue, 23 Jan 2001 22:42:41 +0000 From: Nik Clayton To: Ben Smithurst , grog@freebsd.org Cc: Alexey Zelkin , Ruslan Ermilov , Sheldon Hearn , Mike Pritchard , doc@FreeBSD.org Subject: Re: mdoc(7) questionnaire (was: Re: trailing dot in .Nd) Message-ID: <20010123224241.A1974@canyon.nothing-going-on.org> 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> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010123162819.C29189@comp.leeds.ac.uk>; from csxbcs@comp.leeds.ac.uk on Tue, Jan 23, 2001 at 04:28:19PM +0000 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org 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