Date: Mon, 10 Mar 2003 12:04:52 -0500 From: Tom Rhodes <trhodes@FreeBSD.org> To: Sean Chittenden <sean@chittenden.org> Cc: imp@bsdimp.com, doc@FreeBSD.org, trhodes@FreeBSD.org, dwmalone@FreeBSD.org, src-committers@FreeBSD.org, cvs-src@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/sys/dev/kbd kbd.c Message-ID: <20030310120452.080838a6.trhodes@FreeBSD.org> In-Reply-To: <20030310110025.GS79234@perrin.int.nxad.com> References: <200303092249.h29Mnma3080700@repoman.freebsd.org> <20030309.172900.25160079.imp@bsdimp.com> <20030309225156.7c1ecc11.trhodes@FreeBSD.org> <20030309.213022.95786550.imp@bsdimp.com> <20030310062717.GQ79234@perrin.int.nxad.com> <20030310110025.GS79234@perrin.int.nxad.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, 10 Mar 2003 03:00:26 -0800 Sean Chittenden <sean@chittenden.org> wrote: > [move discussion to doc@] > > > > : Many tunables need documented, its something I've been looking > > > : over. Perhaps a manual page with all the tunables, or a doc in > > > : /usr/share, not sure yet. > > > > > > Well, since this affects the kbd device, it should be in the > > > kbd(4) man page, and maybe the kbdcontrol(1) man pages too. > > > > Tunables all over hell and back is really frustrating for users who > > don't know where to hunt for the meaning of sysctl's. I'm inclined > > to think that sysctl(5) should be used as a table of contents of > > sorts with pointers to other man pages (tuning(7), tcp(4), etc). > > Sure this page will be huge, but it'll be a starting place for all > > admins to find documentation on the output from sysctl -a. At one > > point I had the ambition of normalizing this data in either text > > files or XML but I've since given up on this and think that just > > references from a central man page would suffice and would go a long > > way toward improving the usability of FreeBSD. -sc > > mouth.put(money) > > 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. > > -sc > > -- > Sean Chittenden > Its a wonderful start, perhaps I can use it as my starting point of work... -- Tom Rhodes 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?20030310120452.080838a6.trhodes>