Date: Mon, 10 Mar 2003 12:40:35 -0800 From: Sean Chittenden <seanc@FreeBSD.org> To: David Schultz <das@FreeBSD.ORG> Cc: "M. Warner Losh" <imp@bsdimp.com>, doc@FreeBSD.ORG, trhodes@FreeBSD.ORG, dwmalone@FreeBSD.ORG Subject: Re: your mail Message-ID: <20030310204035.GU79234@perrin.int.nxad.com> In-Reply-To: <20030310195323.GA2812@HAL9000.homeunix.com> References: <20030310195323.GA2812@HAL9000.homeunix.com>
next in thread | previous in thread | raw e-mail | index | archive | help
> > 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030310204035.GU79234>