From owner-freebsd-current  Mon Dec  8 11:17:41 1997
Return-Path: <owner-freebsd-current>
Received: (from root@localhost)
          by hub.freebsd.org (8.8.7/8.8.7) id LAA01083
          for current-outgoing; Mon, 8 Dec 1997 11:17:41 -0800 (PST)
          (envelope-from owner-freebsd-current)
Received: from smtp.algonet.se (tomei.algonet.se [194.213.74.114])
          by hub.freebsd.org (8.8.7/8.8.7) with SMTP id LAA01068
          for <current@FreeBSD.ORG>; Mon, 8 Dec 1997 11:17:30 -0800 (PST)
          (envelope-from johang@mail.algonet.se)
Message-Id: <199712081917.LAA01068@hub.freebsd.org>
Received: (qmail 18231 invoked from network); 8 Dec 1997 20:16:56 +0100
Received: from du28-250.ppp.algonet.se (HELO pegasys) (195.100.250.28)
  by tomei.algonet.se with SMTP; 8 Dec 1997 20:16:56 +0100
Comments: Authenticated sender is <johang@mail.algonet.se>
From: "Johan Granlund" <johan@mail.elpost.com>
To: Eivind Eklund <perhaps@yes.no>
Date: Mon, 8 Dec 1997 20:06:05 +0100
MIME-Version: 1.0
Content-type: text/plain; charset=US-ASCII
Content-transfer-encoding: 7BIT
Subject: Re: VM system info
CC: current@FreeBSD.ORG
Priority: normal
In-reply-to: <19971208093719.50393@follo.net>
References: <199712080706.RAA00375@word.smith.net.au>; from Mike Smith on Mon, Dec 08, 1997 at 05:36:08PM +1030
X-mailer: Pegasus Mail for Win32 (v2.54)
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

I saw a lot of  years ago a package that extracted formatted dokumentation 
from the sources. I dont remember the name but it should have been on a DECUS 
tape.

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

More like newer work.

> 
> Eivind.
> 
/Johan
___________________________________________________________

Internet: Johan@elpost.com

I don't even speak for myself