Date: Sat, 13 Jun 1998 03:07:30 +0200 From: Eivind Eklund <eivind@yes.no> To: Chuck Robey <chuckr@glue.umd.edu>, Mike Smith <mike@smith.net.au> Cc: Nate Williams <nate@mt.sri.com>, dyson@FreeBSD.ORG, hackers@FreeBSD.ORG Subject: Re: kernfs/procfs questions... Message-ID: <19980613030730.29068@follo.net> In-Reply-To: <Pine.BSF.3.96.980612192358.2140O-100000@localhost>; from Chuck Robey on Fri, Jun 12, 1998 at 07:36:09PM -0400 References: <199806042232.PAA02556@dingo.cdrom.com> <Pine.BSF.3.96.980612192358.2140O-100000@localhost>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19980613030730.29068>