From owner-freebsd-doc Mon Mar 10 9: 5:36 2003 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 297AF37B404; Mon, 10 Mar 2003 09:05:33 -0800 (PST) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7742543F75; Mon, 10 Mar 2003 09:05:31 -0800 (PST) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com ([192.168.0.5]) by pittgoth.com (8.12.8/8.12.8) with SMTP id h2AH5LV0015669; Mon, 10 Mar 2003 12:05:22 -0500 (EST) (envelope-from trhodes@FreeBSD.org) Date: Mon, 10 Mar 2003 12:04:52 -0500 From: Tom Rhodes To: Sean Chittenden 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> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.0) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org On Mon, 10 Mar 2003 03:00:26 -0800 Sean Chittenden 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