Date: Wed, 15 Aug 2001 18:13:49 +1000 (EST) From: Bruce Evans <bde@zeta.org.au> To: Ruslan Ermilov <ru@FreeBSD.org> Cc: Alexander Langer <alex@big.endian.de>, <cvs-committers@FreeBSD.org>, <cvs-all@FreeBSD.org> Subject: Re: cvs commit: src/bin/pwd pwd.1 src/bin/sh sh.1 src/gnu/usr.bin/man/manpath manpath.man src/lib/libc/db/man mpool.3 src/lib/libc/net getaddrinfo.3 getipnodebyname.3 src/lib/libc/posix1e acl.3 cap.3 Message-ID: <20010815180724.A19209-100000@besplex.bde.org> In-Reply-To: <20010815100157.C47417@sunbay.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, 15 Aug 2001, Ruslan Ermilov wrote: > On Tue, Aug 14, 2001 at 08:48:26PM +0200, Alexander Langer wrote: > > The xref's have been sorted _logically_. > > Especially DEVICE_IDENTIFY(9)'s SEE ALSO section is unhandsome now. > > > > And I still think MODULE* comes before module*, which is the usual > > UNIX sort method. > > > We have a rule for this, in mdoc(7): > > : It is recommended that the cross references are sorted > : on the section number, then alphabetically on the > : names within a section, and placed in that order and > : comma separated. > > "Alphabetically" means that the case is unimportant. > Think of the SEE ALSO as of a book's Index. I think case is important. It just doesn't make much difference for man pages because most man pages don't have unhandsome upper case names :-). Bruce 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?20010815180724.A19209-100000>