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