From owner-cvs-src Mon Mar 10 3: 0:55 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 62DED37B401; Mon, 10 Mar 2003 03:00:52 -0800 (PST) Received: from perrin.int.nxad.com (internal.ext.nxad.com [69.1.70.251]) by mx1.FreeBSD.org (Postfix) with ESMTP id A26D543F85; Mon, 10 Mar 2003 03:00:51 -0800 (PST) (envelope-from sean@perrin.int.nxad.com) Received: by perrin.int.nxad.com (Postfix, from userid 1001) id 2584A2105B; Mon, 10 Mar 2003 03:00:26 -0800 (PST) Date: Mon, 10 Mar 2003 03:00:26 -0800 From: Sean Chittenden To: "M. Warner Losh" , 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> 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> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="0WzQiIesntPPsVaS" Content-Disposition: inline In-Reply-To: <20030310062717.GQ79234@perrin.int.nxad.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 --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 iD8DBQE+bHBJ3ZnjH7yEs0ERAhKfAJ9vTZbfRANgYm6RhAb+mOR433pjcQCguZ2E b7Jqpt6LUyglV9YZSBPOOv8= =8dXI -----END PGP SIGNATURE----- --0WzQiIesntPPsVaS-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-src" in the body of the message