Date: Mon, 10 Mar 2003 03:00:26 -0800 From: Sean Chittenden <sean@chittenden.org> To: "M. Warner Losh" <imp@bsdimp.com>, doc@FreeBSD.org Cc: 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: <20030310110025.GS79234@perrin.int.nxad.com> In-Reply-To: <20030310062717.GQ79234@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>
next in thread | previous in thread | raw e-mail | index | archive | help
--0WzQiIesntPPsVaS Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable [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. > >=20 > > Well, since this affects the kbd device, it should be in the > > kbd(4) man page, and maybe the kbdcontrol(1) man pages too. >=20 > 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 --=20 Sean Chittenden --0WzQiIesntPPsVaS Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Comment: Sean Chittenden <sean@chittenden.org> iD8DBQE+bHBJ3ZnjH7yEs0ERAhKfAJ9vTZbfRANgYm6RhAb+mOR433pjcQCguZ2E b7Jqpt6LUyglV9YZSBPOOv8= =8dXI -----END PGP SIGNATURE----- --0WzQiIesntPPsVaS-- 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?20030310110025.GS79234>