From owner-cvs-all Thu May 31 1:21:36 2001 Delivered-To: cvs-all@freebsd.org Received: from lists01.iafrica.com (lists01.iafrica.com [196.7.0.141]) by hub.freebsd.org (Postfix) with ESMTP id 7FFC137B422; Thu, 31 May 2001 01:21:29 -0700 (PDT) (envelope-from sheldonh@uunet.co.za) Received: from nwl.fw.uunet.co.za ([196.31.2.162]) by lists01.iafrica.com with esmtp (Exim 3.12 #2) id 155Nht-0004dw-00; Thu, 31 May 2001 10:21:25 +0200 Received: (from nobody@localhost) by nwl.fw.uunet.co.za (8.8.8/8.6.9) id KAA06358; Thu, 31 May 2001 10:21:24 +0200 (SAST) Received: by nwl.fw.uunet.co.za via recvmail id 5953; Thu May 31 10:20:13 2001 Received: from sheldonh (helo=axl.fw.uunet.co.za) by axl.fw.uunet.co.za with local-esmtp (Exim 3.22 #1) id 155Ngj-0003SX-00; Thu, 31 May 2001 10:20:13 +0200 From: Sheldon Hearn To: Udo Erdelhoff Cc: cvs-committers@freebsd.org, cvs-all@freebsd.org Subject: Re: Documenting sysctls (was: cvs commit: src/sbin/sysctl sysctl.8) In-reply-to: Your message of "Thu, 31 May 2001 08:15:15 +0200." <20010531081515.A73265@nathan.ruhr.de> Date: Thu, 31 May 2001 10:20:13 +0200 Message-ID: <13300.991297213@axl.fw.uunet.co.za> 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 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