Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 10 Mar 2003 12:04:52 -0500
From:      Tom Rhodes <trhodes@FreeBSD.org>
To:        Sean Chittenden <sean@chittenden.org>
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>

next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, 10 Mar 2003 03:00:26 -0800
Sean Chittenden <sean@chittenden.org> 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 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?20030310120452.080838a6.trhodes>