From owner-cvs-src Sun Mar 9 22:27:47 2003 Delivered-To: cvs-src@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id AC5BA37B401; Sun, 9 Mar 2003 22:27:43 -0800 (PST) Received: from perrin.int.nxad.com (internal.ext.nxad.com [69.1.70.251]) by mx1.FreeBSD.org (Postfix) with ESMTP id CF61143F75; Sun, 9 Mar 2003 22:27:42 -0800 (PST) (envelope-from sean@perrin.int.nxad.com) Received: by perrin.int.nxad.com (Postfix, from userid 1001) id 11B8321068; Sun, 9 Mar 2003 22:27:18 -0800 (PST) Date: Sun, 9 Mar 2003 22:27:17 -0800 From: Sean Chittenden To: "M. Warner Losh" 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> References: <200303092249.h29Mnma3080700@repoman.freebsd.org> <20030309.172900.25160079.imp@bsdimp.com> <20030309225156.7c1ecc11.trhodes@FreeBSD.org> <20030309.213022.95786550.imp@bsdimp.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="pndui+VhQ7yNUqd0" Content-Disposition: inline In-Reply-To: <20030309.213022.95786550.imp@bsdimp.com> User-Agent: Mutt/1.4i X-PGP-Key: finger seanc@FreeBSD.org X-PGP-Fingerprint: 3849 3760 1AFE 7B17 11A0 83A6 DD99 E31F BC84 B341 X-Web-Homepage: http://sean.chittenden.org/ Sender: owner-cvs-src@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG --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 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