From owner-cvs-all Thu May 31 8:28:50 2001 Delivered-To: cvs-all@freebsd.org Received: from odin.ac.hmc.edu (Odin.AC.HMC.Edu [134.173.32.75]) by hub.freebsd.org (Postfix) with ESMTP id 5E27537B423; Thu, 31 May 2001 08:28:42 -0700 (PDT) (envelope-from brdavis@odin.ac.hmc.edu) Received: (from brdavis@localhost) by odin.ac.hmc.edu (8.11.0/8.11.0) id f4VFSKN15600; Thu, 31 May 2001 08:28:20 -0700 Date: Thu, 31 May 2001 08:28:20 -0700 From: Brooks Davis To: Sheldon Hearn Cc: Udo Erdelhoff , 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> References: <20010531081515.A73265@nathan.ruhr.de> <13300.991297213@axl.fw.uunet.co.za> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="BOKacYhQ+x31HxR3" Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <13300.991297213@axl.fw.uunet.co.za>; from sheldonh@starjuice.net on Thu, May 31, 2001 at 10:20:13AM +0200 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 --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