From owner-cvs-all Wed Aug 15 0: 2:34 2001 Delivered-To: cvs-all@freebsd.org Received: from whale.sunbay.crimea.ua (whale.sunbay.crimea.ua [212.110.138.65]) by hub.freebsd.org (Postfix) with ESMTP id 1C4DB37B40C; Wed, 15 Aug 2001 00:02:24 -0700 (PDT) (envelope-from ru@whale.sunbay.crimea.ua) Received: (from ru@localhost) by whale.sunbay.crimea.ua (8.11.2/8.11.2) id f7F71vK50999; Wed, 15 Aug 2001 10:01:57 +0300 (EEST) (envelope-from ru) Date: Wed, 15 Aug 2001 10:01:57 +0300 From: Ruslan Ermilov To: Alexander Langer Cc: 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 cap_get_proc.3 posix1e.3 ... Message-ID: <20010815100157.C47417@sunbay.com> References: <200107061646.f66Gkmf53701@freefall.freebsd.org> <20010814204826.A22531@zerogravity.kawo2.rwth-aachen.d> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010814204826.A22531@zerogravity.kawo2.rwth-aachen.d>; from alex@big.endian.de on Tue, Aug 14, 2001 at 08:48:26PM +0200 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 Tue, Aug 14, 2001 at 08:48:26PM +0200, Alexander Langer wrote: > Thus spake Ruslan Ermilov (ru@FreeBSD.org): > > > share/man/man9 DECLARE_MODULE.9 DEVICE_IDENTIFY.9 > > DEV_MODULE.9 DRIVER_MODULE.9 > > MODULE_DEPEND.9 MODULE_VERSION.9 > > mdoc(7) police: sort SEE ALSO xrefs (sort -b -f +2 -3 +1 -2). > > 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. 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