Subject: Re: CVS commit: src/sys/kern
To: Andrew Brown <atatat@atatdot.net>
From: Aymeric Vincent <vincent@labri.fr>
List: source-changes
Date: 04/08/2004 16:46:02
Andrew Brown wrote:

> 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?

I agree with Matthew here. Kernel memory is very expensive, and of all 
kernel bloat, I think self-documentation like this should be the first 
to go away.

> some things aren't documented at all, and this at least provides a
> *comment* about what it might be.

This could be true of every single concept and object in the kernel.

> i don't know which man page describes what
> net.inet6.ip6.use_deprecated does; sysctl.8 merely makes mention of
> its existence.

Then maybe the name of the variable is not well chosen, but to be more 
constructive, how about having a manual entry for every variable (full 
path), pointing to the man page that contains its description? I would 
rather see a forest of symlinks on my hard disk than plain text wired 
in memory forever.

  Aymeric