From owner-freebsd-current  Mon Dec  8 00:38:03 1997
Return-Path: <owner-freebsd-current>
Received: (from root@localhost)
          by hub.freebsd.org (8.8.7/8.8.7) id AAA17500
          for current-outgoing; Mon, 8 Dec 1997 00:38:03 -0800 (PST)
          (envelope-from owner-freebsd-current)
Received: from ns1.yes.no (ns1.yes.no [195.119.24.10])
          by hub.freebsd.org (8.8.7/8.8.7) with ESMTP id AAA17490;
          Mon, 8 Dec 1997 00:37:53 -0800 (PST)
          (envelope-from eivind@bitbox.follo.net)
Received: from bitbox.follo.net (bitbox.follo.net [194.198.43.36])
	by ns1.yes.no (8.8.7/8.8.7) with ESMTP id IAA11964;
	Mon, 8 Dec 1997 08:37:50 GMT
Received: (from eivind@localhost)
	by bitbox.follo.net (8.8.6/8.8.6) id JAA11375;
	Mon, 8 Dec 1997 09:37:19 +0100 (MET)
Message-ID: <19971208093719.50393@follo.net>
Date: Mon, 8 Dec 1997 09:37:19 +0100
From: Eivind Eklund <eivind@yes.no>
To: Mike Smith <mike@smith.net.au>
Cc: Eivind Eklund <perhaps@yes.no>, dyson@FreeBSD.ORG, current@FreeBSD.ORG
Subject: Re: VM system info
References: <867m9gpsts.fsf@bitbox.follo.net> <199712080706.RAA00375@word.smith.net.au>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.88e
In-Reply-To: <199712080706.RAA00375@word.smith.net.au>; from Mike Smith on Mon, Dec 08, 1997 at 05:36:08PM +1030
Sender: owner-freebsd-current@FreeBSD.ORG
X-Loop: FreeBSD.org
Precedence: bulk

On Mon, Dec 08, 1997 at 05:36:08PM +1030, Mike Smith wrote:
> > I want this info in the kernel.  At the very least, I want
> > documentation as a part of the SYSCTL_*() macro parameters, unused but 
> > available as a (mandatory) part of the source - better would be as a
> > part of the kernel that can be compiled away by setting a kernel
> > option (e.g. NO_SYSCTL_DOCS).
> 
> Would you buy it in /usr/share/misc/sysctl_nodes?  I was thinking about 
> that when I saved John's message...

If extracted from the kernel source, I'd say it was OK.  However, if
this is a file that developers are supposed to to keep up to date
manually, I'm much more sceptical.  Keeping documentation outside the
source up to date has a tendency to be forgotten/ignored.

Eivind.