From owner-freebsd-doc Mon Mar 10 12:41: 4 2003 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6D72437B401; Mon, 10 Mar 2003 12:41:03 -0800 (PST) Received: from perrin.int.nxad.com (internal.ext.nxad.com [69.1.70.251]) by mx1.FreeBSD.org (Postfix) with ESMTP id 87EC243F93; Mon, 10 Mar 2003 12:41:01 -0800 (PST) (envelope-from sean@perrin.int.nxad.com) Received: by perrin.int.nxad.com (Postfix, from userid 1001) id 7909F2105B; Mon, 10 Mar 2003 12:40:35 -0800 (PST) Date: Mon, 10 Mar 2003 12:40:35 -0800 From: Sean Chittenden To: David Schultz Cc: "M. Warner Losh" , doc@FreeBSD.ORG, trhodes@FreeBSD.ORG, dwmalone@FreeBSD.ORG Subject: Re: your mail Message-ID: <20030310204035.GU79234@perrin.int.nxad.com> References: <20030310195323.GA2812@HAL9000.homeunix.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030310195323.GA2812@HAL9000.homeunix.com> User-Agent: Mutt/1.4i X-PGP-Key: finger seanc@FreeBSD.org X-PGP-Fingerprint: 3849 3760 1AFE 7B17 11A0 83A6 DD99 E31F BC84 B341 X-Web-Homepage: http://sean.chittenden.org/ Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org > > It's just a skeleton at this point with only a few MIBs filled in, > > but unless there's a strong objection, it'd be great to get this > > flushed out over time. The man pages that the various MIBs > > reference should contain the appropriate information about what > > these MIB values mean and how to adjust them, and what levels are > > appropriate. > > > > http://people.freebsd.org/~seanc/patches/#sysctl_5_start > > > > It isn't automatically generated, but it's a start and given that > > there are only a handful of MIBs that come into existence every > > month or so, I think it's reasonable to have this file maintained > > by hand. > > Very cool. I think it might be a better idea to move the > centralized list to the handbook, since hypertext is a better medium > for a list that will potentially be very long and contain many > cross-references. Short descriptions next to MIBs would be nice. > Also, sorting first by category and then by alphabetical order might > be more helpful. ::shakes head violently in disagreement:: NOOOOOOOOO!!!! :-P While I agree with you on the technological front regarding hyper-links, the whole point of having this in a man page is to be able to help the admin that's up late at night trying to figure out why a certain value is set to what and where to change it in the config. If we'd like to have this in the handbook, so be it, but I think the primary effort should be in mdoc for usability and ease of use (unless of course the mdoc sources are built from DocBook: see earlier post on the topic). -sc -- Sean Chittenden To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message