Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 15 Aug 2001 10:01:57 +0300
From:      Ruslan Ermilov <ru@FreeBSD.org>
To:        Alexander Langer <alex@big.endian.de>
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>
In-Reply-To: <20010814204826.A22531@zerogravity.kawo2.rwth-aachen.d>; from alex@big.endian.de on Tue, Aug 14, 2001 at 08:48:26PM %2B0200
References:  <200107061646.f66Gkmf53701@freefall.freebsd.org> <20010814204826.A22531@zerogravity.kawo2.rwth-aachen.d>

next in thread | previous in thread | raw e-mail | index | archive | help
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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010815100157.C47417>