Date: Mon, 10 Mar 2003 20:52:39 -0800 From: David Schultz <das@FreeBSD.org> To: Sean Chittenden <seanc@FreeBSD.org> Cc: "M. Warner Losh" <imp@bsdimp.com>, doc@FreeBSD.org, trhodes@FreeBSD.org, dwmalone@FreeBSD.org Subject: Re: your mail Message-ID: <20030311045239.GA4369@HAL9000.homeunix.com> In-Reply-To: <20030310204035.GU79234@perrin.int.nxad.com> References: <20030310195323.GA2812@HAL9000.homeunix.com> <20030310204035.GU79234@perrin.int.nxad.com>
next in thread | previous in thread | raw e-mail | index | archive | help
Thus spake Sean Chittenden <seanc@FreeBSD.org>: > > 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 Actually, I was thinking of the fact that properly laid out DocBook can be converted into a (slightly more concise) mdoc file. I have nothing against a manpage listing all of the sysctls, but I think that centralizing the information in an SGML-based format would be much more useful in the long run. And since you can make a manpage out of that, the only disadvantage I see is the extra work to put together the DocBook stuff and figure out how to do the conversion. 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?20030311045239.GA4369>