From owner-cvs-all Wed Aug 15 1:16:32 2001 Delivered-To: cvs-all@freebsd.org Received: from mailman.zeta.org.au (mailman.zeta.org.au [203.26.10.16]) by hub.freebsd.org (Postfix) with ESMTP id B577337B40A; Wed, 15 Aug 2001 01:16:26 -0700 (PDT) (envelope-from bde@zeta.org.au) Received: from bde.zeta.org.au (bde.zeta.org.au [203.2.228.102]) by mailman.zeta.org.au (8.9.3/8.8.7) with ESMTP id SAA18188; Wed, 15 Aug 2001 18:16:25 +1000 Date: Wed, 15 Aug 2001 18:13:49 +1000 (EST) From: Bruce Evans X-X-Sender: To: Ruslan Ermilov Cc: Alexander Langer , , 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 In-Reply-To: <20010815100157.C47417@sunbay.com> Message-ID: <20010815180724.A19209-100000@besplex.bde.org> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG 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