From owner-cvs-all Thu Aug 16 7:28:27 2001 Delivered-To: cvs-all@freebsd.org Received: from fledge.watson.org (fledge.watson.org [204.156.12.50]) by hub.freebsd.org (Postfix) with ESMTP id EEB4837B406; Thu, 16 Aug 2001 07:28:19 -0700 (PDT) (envelope-from robert@fledge.watson.org) Received: from fledge.watson.org (robert@fledge.pr.watson.org [192.0.2.3]) by fledge.watson.org (8.11.4/8.11.4) with SMTP id f7GERcf84495; Thu, 16 Aug 2001 10:27:38 -0400 (EDT) (envelope-from robert@fledge.watson.org) Date: Thu, 16 Aug 2001 10:27:37 -0400 (EDT) From: Robert Watson X-Sender: robert@fledge.watson.org To: Sheldon Hearn 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: <7507.997953894@axl.seasidesoftware.co.za> Message-ID: 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 Thu, 16 Aug 2001, Sheldon Hearn wrote: > On Thu, 16 Aug 2001 10:43:02 +0930, Greg Lehey wrote: > > > If a man page writer has a particular reason for a specific sequence, > > I don't think other people should go in and change it. > > As both a reader and writer of manual pages, I don't like that. I like > consistency in the SEE ALSO section so that I don't have to think as > much when I scan it for something I suspect might be there. 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. :-) Robert N M Watson FreeBSD Core Team, TrustedBSD Project robert@fledge.watson.org NAI Labs, Safeport Network Services To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message