Date: Wed, 15 Aug 2001 11:46:33 +0300 From: Ruslan Ermilov <ru@FreeBSD.org> To: Bruce Evans <bde@zeta.org.au> 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: <20010815114633.A61889@sunbay.com> In-Reply-To: <20010815180724.A19209-100000@besplex.bde.org>; from bde@zeta.org.au on Wed, Aug 15, 2001 at 06:13:49PM %2B1000 References: <20010815100157.C47417@sunbay.com> <20010815180724.A19209-100000@besplex.bde.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, Aug 15, 2001 at 06:13:49PM +1000, Bruce Evans wrote: > 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 > :-). > Well, I looked at the several of my books, including "TCP/IP Illustrated" by Stevens and "The Design and Implementation of the 4.4BSD Operating System" by McKusick (both books published by AWL), and they had their Index sorted alphabetically, not lexicographically. Cheers, -- Ruslan Ermilov Oracle Developer/DBA, ru@sunbay.com Sunbay Software AG, ru@FreeBSD.org FreeBSD committer, +380.652.512.251 Simferopol, Ukraine http://www.FreeBSD.org The Power To Serve http://www.oracle.com Enabling The Information Age 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?20010815114633.A61889>