Date: Thu, 16 Aug 2001 09:47:48 -0600 From: Warner Losh <imp@harmony.village.org> To: Sheldon Hearn <sheldonh@starjuice.net> 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> 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 ...) Message-ID: <200108161547.f7GFlmW33386@harmony.village.org> In-Reply-To: Your message of "Thu, 16 Aug 2001 11:24:54 %2B0200." <7507.997953894@axl.seasidesoftware.co.za> References: <7507.997953894@axl.seasidesoftware.co.za>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200108161547.f7GFlmW33386>