From owner-freebsd-doc Mon Jan 22 11: 5:37 2001 Delivered-To: freebsd-doc@freebsd.org Received: from csunb0.leeds.ac.uk (csunb0.leeds.ac.uk [129.11.144.2]) by hub.freebsd.org (Postfix) with SMTP id 32EB437B699; Mon, 22 Jan 2001 11:05:18 -0800 (PST) Received: from cslin.leeds.ac.uk (csunc0.leeds.ac.uk [129.11.144.3]) by csunb0.leeds.ac.uk (8.6.12/8.6.12) with ESMTP id SAA26764; Mon, 22 Jan 2001 18:53:05 GMT Received: from cslin-gps.comp (cslin-gps [129.11.144.9]) by cslin.leeds.ac.uk (8.9.3+Sun/) with ESMTP id SAA17931; Mon, 22 Jan 2001 18:53:07 GMT Date: Mon, 22 Jan 2001 18:53:04 +0000 From: Ben Smithurst To: Ruslan Ermilov Cc: Sheldon Hearn , Alexey Zelkin , Mike Pritchard , doc@FreeBSD.org Subject: Re: trailing dot in .Nd Message-ID: <20010122185304.B25101@comp.leeds.ac.uk> References: <20010122175432.A31943@sunbay.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010122175432.A31943@sunbay.com> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Ruslan Ermilov wrote: > There are 26 -CURRENT manpages (in mdoc(7) format) in the base system > that have a trailing dot (`.') after the .Nd macro. In your opinion, > should I remove these (dots)? > > gnu/lib/libdialog/dialog.3:.Nd provide a simple ncurses-based GUI interface. No objections from me, and it would certainmly make things more consistent. We should also be consistent about not starting with a capital letter... > lib/libc/sys/jail.2:.Nd Imprison current process and future decendants. > lib/libcalendar/calendar.3:.Nd Calendar arithmetic for the Christian era. > share/man/man9/DELAY.9:.Nd Busy loop for an interval. > share/man/man9/bios.9:.Nd Interact with PC BIOS. They should be lowercase, IMO. ... I'm tempted also to change things like ".Nm Foo" to just ".Nm" at the start of sentences, when the name really is "foo". IMO even at the start of a sentence we shouldn't capitalize things wrong. There's a lot more of these to change though, so there may be stronger objections. I don't feel that strongly about it, it just seems "wrong" to capitalize things wrong. -- Ben Smithurst / csxbcs@comp.leeds.ac.uk / ben@FreeBSD.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message