From owner-cvs-all  Thu Aug 16  8:48: 5 2001
Delivered-To: cvs-all@freebsd.org
Received: from rover.village.org (rover.bsdimp.com [204.144.255.66])
	by hub.freebsd.org (Postfix) with ESMTP
	id 243D737B40B; Thu, 16 Aug 2001 08:47:58 -0700 (PDT)
	(envelope-from imp@harmony.village.org)
Received: from harmony.village.org (harmony.village.org [10.0.0.6])
	by rover.village.org (8.11.3/8.11.3) with ESMTP id f7GFloq17019;
	Thu, 16 Aug 2001 09:47:50 -0600 (MDT)
	(envelope-from imp@harmony.village.org)
Received: from harmony.village.org (localhost.village.org [127.0.0.1])
	by harmony.village.org (8.11.3/8.11.4) with ESMTP id f7GFlmW33386;
	Thu, 16 Aug 2001 09:47:48 -0600 (MDT)
	(envelope-from imp@harmony.village.org)
Message-Id: <200108161547.f7GFlmW33386@harmony.village.org>
To: Sheldon Hearn <sheldonh@starjuice.net>
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 ...) 
Cc: Greg Lehey <grog@FreeBSD.org>, Ruslan Ermilov <ru@FreeBSD.org>,
	Alexander Langer <alex@big.endian.de>, cvs-committers@FreeBSD.org,
	cvs-all@FreeBSD.org, Bruce Evans <bde@zeta.org.au>
In-reply-to: Your message of "Thu, 16 Aug 2001 11:24:54 +0200."
		<7507.997953894@axl.seasidesoftware.co.za> 
References: <7507.997953894@axl.seasidesoftware.co.za>  
Date: Thu, 16 Aug 2001 09:47:48 -0600
From: Warner Losh <imp@harmony.village.org>
Sender: owner-cvs-all@FreeBSD.ORG
Precedence: bulk
List-ID: <cvs-all.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20cvs-all>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20cvs-all>
X-Loop: FreeBSD.ORG

In message <7507.997953894@axl.seasidesoftware.co.za> Sheldon Hearn writes:
: > 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.

I'd like to see things in alphabetical order, unless there's a real
compelling reason not to.  And if there is a reason, it should be
documented.  Otherwise, how do you tell the sloppy manual writer(s)
from the clever, but obscure?

Warner

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message