From owner-cvs-all Thu Aug 16 7:40:15 2001 Delivered-To: cvs-all@freebsd.org Received: from axl.seasidesoftware.co.za (axl.seasidesoftware.co.za [196.31.7.201]) by hub.freebsd.org (Postfix) with ESMTP id 09BEA37B409; Thu, 16 Aug 2001 07:40:08 -0700 (PDT) (envelope-from sheldonh@starjuice.net) Received: from sheldonh (helo=axl.seasidesoftware.co.za) by axl.seasidesoftware.co.za with local-esmtp (Exim 3.31 #1) id 15XOKw-0000oF-00; Thu, 16 Aug 2001 16:41:30 +0200 From: Sheldon Hearn To: Robert Watson Cc: Greg Lehey , Ruslan Ermilov , Alexander Langer , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org, Bruce Evans Subject: Re: "Rules" in documentation (was: 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 ...) In-reply-to: Your message of "Thu, 16 Aug 2001 10:27:37 -0400." Date: Thu, 16 Aug 2001 16:41:30 +0200 Message-ID: <3114.997972890@axl.seasidesoftware.co.za> 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 Thu, 16 Aug 2001 10:27:37 -0400, Robert Watson wrote: > BTW, in the sorting of SEE ALSO sections in my larger man pages, I tend to > use the man page section of the cross-reference as the primary sorting > key, followed by case-insensitive remainder. That way if I > cross-reference commands, kernel functions, and libraries, they end up > sorted usefully, rather than mixed up. That could just be me, however. > :-) No, that's almost exactly how it _should_ be done: .Xr bar 1 , .Xr FOO 1 , .Xr foo 1 , .Xr foo 2 , .Xr bar 3 Ciao, Sheldon. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message