Subject: Re: CVS commit: src/sys/kern
To: Andrew Brown <atatat@atatdot.net>
From: John Hawkinson <jhawk@MIT.EDU>
List: source-changes
Date: 04/08/2004 11:33:21
Andrew Brown <atatat@atatdot.net> wrote on Thu,  8 Apr 2004
at 08:52:54 -0400 in <20040408085254.B22368@noc.untraceable.net>:


> like i said in the commit message (which has been lost), if you don't
> want them, you don't have to have them.  as for me, the 152 (out of
> the 425 nodes in my tree) that are done cost me about 5k, but i like
> knowing what all that stuff is, without having to wade through who
> knows which man page?

Simply adding knobs is not sufficient. We're in a world where defaults
matter, and good design matters. You should strive for a solution
that works for everyone.

It sounds to me like you should adjust the sysctl mechanism
such that it generates documentation files automatically. This
doesn't seem too difficult. Instead of putting the text in the kernel,
put it in a man page, or put it in a file somewhere else.

Can this discussion please be re-spun on some other mailing list?

--jhawk