Date: Thu, 31 May 2001 00:50:26 +0200 From: Sheldon Hearn <sheldonh@starjuice.net> To: Jesper Skriver <jesper@skriver.dk> Cc: Greg Lehey <grog@freebsd.org>, Dima Dorfman <dd@freebsd.org>, cvs-committers@freebsd.org, cvs-all@freebsd.org Subject: Re: Documenting sysctls (was: cvs commit: src/sbin/sysctl sysctl.8) Message-ID: <25323.991263026@axl.fw.uunet.co.za> In-Reply-To: Your message of "Thu, 31 May 2001 00:39:43 %2B0200." <20010531003943.E78414@skriver.dk>
next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, 31 May 2001 00:39:43 +0200, Jesper Skriver wrote: > If we can agree it's in sysctl(8) it should be, I'll start with > the net.inet ones, apart from the net.inet.tcp ones which are in tcp(4) Last time this came up, there were two schools of thought: 1) Document all the sysctls in one place so they're easy to find. 2) Document each sysctl in the documentation for the device that it controls. The second option is great for thorough documentation, because it means that the description can rely on the surrounding text of the manual page. The problem is that not all sysctl's belong to a specific device. I think a balance can be struck, where sysctls that belong to a device are documented in the documentation for that device, while sysctls that don't can be documented in sysctl(8) (or some other common place). Ciao, Sheldon. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?25323.991263026>