From owner-cvs-all Mon Nov 29 13:45:49 1999 Delivered-To: cvs-all@freebsd.org Received: from alcanet.com.au (border.alcanet.com.au [203.62.196.10]) by hub.freebsd.org (Postfix) with ESMTP id 2241815415; Mon, 29 Nov 1999 13:45:40 -0800 (PST) (envelope-from jeremyp@gsmx07.alcatel.com.au) Received: by border.alcanet.com.au id <40338>; Tue, 30 Nov 1999 08:38:14 +1100 Content-return: prohibited Date: Tue, 30 Nov 1999 08:45:28 +1100 From: Peter Jeremy Subject: Re: cvs commit: src/sys/i386/conf files.i386 src/sys/kern kern_fork.c src/sys/libkern arc4random.c src/sys/sys libkern.h In-reply-to: To: Bill Fumerola Cc: "Jordan K. Hubbard" , Dan Moschuk , cvs-committers@FreeBSD.ORG, cvs-all@FreeBSD.ORG Reply-To: peter.jeremy@alcatel.com.au Message-Id: <99Nov30.083814est.40338@border.alcanet.com.au> MIME-version: 1.0 X-Mailer: Mutt 1.0pre3i Content-type: text/plain; charset=us-ascii References: <83454.943870526@zippy.cdrom.com> Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk On 1999-Nov-30 04:38:30 +1100, Bill Fumerola wrote: >On Mon, 29 Nov 1999, Jordan K. Hubbard wrote: > >> Hmmm. A fine thing, but one small point: Are we actually documenting >> these new knobs anywhere? :-) > >We could do so in the appropriate field in SYSCTL_* but it doesn't >exactly work.... Making them work is a really trivial problem. Making them work without bloating the kernel is a somewhat less trivial problem, but quite doable. (I have one kernel-land implementation, but have been fighting with the linker to get it to do what I want - which would simplify the userland side). In any case, any new sysctl knobs should be adequately documented using the relevant documentation field. (And the old knobs should be updated as time permits). At worst, we can use a trivial perl or awk script to pull the documentation fields out of the source. Peter To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message