Date: Sun, 9 Mar 2003 22:27:17 -0800 From: Sean Chittenden <sean@chittenden.org> To: "M. Warner Losh" <imp@bsdimp.com> 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: <20030310062717.GQ79234@perrin.int.nxad.com> In-Reply-To: <20030309.213022.95786550.imp@bsdimp.com> References: <200303092249.h29Mnma3080700@repoman.freebsd.org> <20030309.172900.25160079.imp@bsdimp.com> <20030309225156.7c1ecc11.trhodes@FreeBSD.org> <20030309.213022.95786550.imp@bsdimp.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--pndui+VhQ7yNUqd0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable > : > : No objections from: -audit about 6 moths ago > : >=20 > : > I seem to recall objecting to this in the past. If you have ddb > : > enabled, then this sysctl is useless.... This fact should at least be > : > documented. As should this sysctl... > : >=20 > : > Warner > : >=20 > :=20 > : 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. 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 --=20 Sean Chittenden --pndui+VhQ7yNUqd0 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Comment: Sean Chittenden <sean@chittenden.org> iD8DBQE+bDBF3ZnjH7yEs0ERApGmAJ9cJsCzx99EJ1p7uiHg5EFROIs7xQCfVARN KVh83qR7PZ6cRGhDg39S62w= =RXuI -----END PGP SIGNATURE----- --pndui+VhQ7yNUqd0-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-src" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030310062717.GQ79234>