Date: Thu, 31 May 2001 08:28:20 -0700 From: Brooks Davis <brooks@one-eyed-alien.net> To: Sheldon Hearn <sheldonh@starjuice.net> Cc: Udo Erdelhoff <ue@nathan.ruhr.de>, cvs-committers@FreeBSD.ORG, cvs-all@FreeBSD.ORG Subject: Re: Documenting sysctls (was: cvs commit: src/sbin/sysctl sysctl.8) Message-ID: <20010531082820.A13979@Odin.AC.HMC.Edu> In-Reply-To: <13300.991297213@axl.fw.uunet.co.za>; from sheldonh@starjuice.net on Thu, May 31, 2001 at 10:20:13AM %2B0200 References: <20010531081515.A73265@nathan.ruhr.de> <13300.991297213@axl.fw.uunet.co.za>
next in thread | previous in thread | raw e-mail | index | archive | help
--BOKacYhQ+x31HxR3 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Thu, May 31, 2001 at 10:20:13AM +0200, Sheldon Hearn wrote: > On Thu, 31 May 2001 08:15:15 +0200, Udo Erdelhoff wrote: >=20 > > 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. >=20 > The disadvantage, of course, is the hassle of maintenance. >=20 > 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 definatly prefer Udo's suggestion. I really do want some where I can search for any sysctl and find where it is documented. If I knew they were documented be prefixes I would eventualy find them, but being able to search for exact matches would be nice. As you said though, "he who does the work, picks the color." -- Brooks --=20 Any statement of the form "X is the one, true Y" is FALSE. PGP fingerprint 655D 519C 26A7 82E7 2529 9BF0 5D8E 8BE9 F238 1AD4 --BOKacYhQ+x31HxR3 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.4 (GNU/Linux) Comment: For info see http://www.gnupg.org iD8DBQE7FmMTXY6L6fI4GtQRAhCLAKDnuDrq8FQIqmJep9fyAP6TQqT6zACeIwVG 5cew4YPkbr3imzpi/meTGw0= =0LyF -----END PGP SIGNATURE----- --BOKacYhQ+x31HxR3-- 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?20010531082820.A13979>