> On Sat, Nov 18, 2006 at 07:49:23PM +0900, YAMAMOTO Takashi wrote:
> > > We should have a documentation for sysctl MIBs that is inluded in man.tgz
> > > and uses MIB names, not the constants. (in a new sysctl.7 ?)
> > 
> > i think it's a good idea.  do you want to do it? :)
> 
> What exactly would it mean? My idea was to completely remove the
> symbolic constants (CTL_* etc.) and the header files where they can be
> found from sysctl.3, in the descriptions replace the constants by MIB
> names (e.g. CTL_HW -> hw, HW_MACHINE -> machine) and move the
> descriptions to sysctl.7, leaving only the documentation of the
> sysctl*() functions and some examples in sysctl.3 . Do you agree with
> that, or should the symbolic constants remain documented somewhere?
> 
> Pavel

i agree that the following
	
	HW_MACHINE
		The machine class.

should be

	machine
		The machine class.

or

	machine (HW_MACHINE)
		The machine class.

if we want to keep constants documented, the above "(HW_MACHINE)"
is enough, IMO.

i agree it's better to move them from sysctl.3 to a dedicated page, too.

YAMAMOTO Takashi