On Wed, Apr 27, 2005 at 03:28:53PM +0930, Glen Turner wrote:
> Please mail me with what you think is required here. I've
> been getting grief from our high performance users on
> exactly this point (and the sysctl maze of twisty options)
sysctl is mostly documented in Documentation/*.
Also the sysctls change sometimes, so I am not sure it is a good idea
to put them into the manpages which are supposed to be more version
independent. At least I would only put the more important ones there.
In particular the ipv6 protocol manpage needs a rewrite, it was only a
relatively poor quick&dirty job. For the others it would be probably
sufficient to just check what new ioctls/socket options are missing
and document them and perhaps check if the NOTES/BUGS caveats still
apply. An sctp manpage is also lacking I think, that was a completely
new protocol.
It would be nice of course if David could enforce a policy
to require a manpage patch for new ioctls/socket options etc.
in the future, then such documentation lag would not happen.
-Andi
|