From owner-freebsd-hackers Fri Jun 12 18:08:07 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id SAA00488 for freebsd-hackers-outgoing; Fri, 12 Jun 1998 18:08:07 -0700 (PDT) (envelope-from owner-freebsd-hackers@FreeBSD.ORG) Received: from ns1.yes.no (ns1.yes.no [195.119.24.10]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id SAA00383; Fri, 12 Jun 1998 18:07:48 -0700 (PDT) (envelope-from eivind@bitbox.follo.net) Received: from bitbox.follo.net (bitbox.follo.net [195.204.143.218]) by ns1.yes.no (8.8.7/8.8.7) with ESMTP id BAA18939; Sat, 13 Jun 1998 01:07:32 GMT Received: (from eivind@localhost) by bitbox.follo.net (8.8.8/8.8.6) id DAA00402; Sat, 13 Jun 1998 03:07:30 +0200 (MET DST) Message-ID: <19980613030730.29068@follo.net> Date: Sat, 13 Jun 1998 03:07:30 +0200 From: Eivind Eklund To: Chuck Robey , Mike Smith Cc: Nate Williams , dyson@FreeBSD.ORG, hackers@FreeBSD.ORG Subject: Re: kernfs/procfs questions... References: <199806042232.PAA02556@dingo.cdrom.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.89.1i In-Reply-To: ; from Chuck Robey on Fri, Jun 12, 1998 at 07:36:09PM -0400 Sender: owner-freebsd-hackers@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG On Fri, Jun 12, 1998 at 07:36:09PM -0400, Chuck Robey wrote: > Could I make a suggestion? How about allowing the documentation on > sysctl to be outside the norm a little, so as to make it much easier for > folks adding new ones to make the doc? This eliminates the need to add > the troff/man formatting, which can bre a pain. Something like a file > in /usr/share/doc (maybe /usr/share/doc/sysctl.list) where every new > knob needs to get a short def, of a form that encourages (at least) a > minimum in completeness? This would allow huge howls if a new sysctl > was implemented without a doc entry. The man page on sysctl could refer > to that file, and everyone wouldn't have to stumble over troff. % cat /usr/include/sys/sysctl.h | grep 'define.*SYSCTL_OID' #define SYSCTL_OID(parent, nbr, name, kind, a1, a2, handler, fmt, descr) \ % That descr is for description. I can't see any way we can make this easier - you only type a string into the place you define the sysctl anyway. Of course, people tend to put empty strings there - so let's peer-pressure them a little ;-) Eivind. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message