Date: Thu, 31 May 2001 10:20:13 +0200 From: Sheldon Hearn <sheldonh@starjuice.net> To: Udo Erdelhoff <ue@nathan.ruhr.de> Cc: cvs-committers@freebsd.org, cvs-all@freebsd.org Subject: Re: Documenting sysctls (was: cvs commit: src/sbin/sysctl sysctl.8) Message-ID: <13300.991297213@axl.fw.uunet.co.za> In-Reply-To: Your message of "Thu, 31 May 2001 08:15:15 %2B0200." <20010531081515.A73265@nathan.ruhr.de>
next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, 31 May 2001 08:15:15 +0200, Udo Erdelhoff wrote: > The former version has the obvious advantage that you can take a sysctl, > drop it into the search function of your $MANPAGER and find the pointer > (or the actual description) in one try. In the latter version, you'd > have to cut your search string again and again until you get a match. The disadvantage, of course, is the hassle of maintenance. I should finally have time to actually contribute documentation and code to the project again soon. If I'm the guy who ends up doing this, I'll almost certainly do it exactly as Brooks Davis suggested, as it'll ease maintenance without degrading the usefulness of the documentation, your comments notwithstanding. I've promised to do some work for Kris Kennaway first, so someone else may beat me to the punch here. Since all the suggestions put forward will work to some degree, I think this is one of those things where Poul-Henning's philosophy of "he who builds it chooses the colour" will work well. Ciao, Sheldon. 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?13300.991297213>