From owner-cvs-all Sun Jan 10 21:10:22 1999 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id VAA05026 for cvs-all-outgoing; Sun, 10 Jan 1999 21:10:22 -0800 (PST) (envelope-from owner-cvs-all@FreeBSD.ORG) Received: from ctserv.itfs.nsk.su (F-router.itfs.nsk.su [212.20.32.65]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id VAA05002 for ; Sun, 10 Jan 1999 21:10:19 -0800 (PST) (envelope-from nnd@ctserv.itfs.nsk.su) Received: (from nnd@localhost) by ctserv.itfs.nsk.su (8.8.8/8.8.8) id LAA17557; Mon, 11 Jan 1999 11:10:41 +0600 (NS) (envelope-from nnd) Date: Mon, 11 Jan 1999 11:10:41 +0600 (NS) From: "Nickolay N. Dudorov" Message-Id: <199901110510.LAA17557@ctserv.itfs.nsk.su> To: sthaug@nethelp.no Subject: Re: sysctl descriptions Cc: cvs-all@FreeBSD.ORG In-Reply-To: <199901101200.XAA13355@godzilla.zeta.org.au> <22387.915970310@verdi.nethelp.no> User-Agent: tin/pre-1.4-980818 ("Laura") (UNIX) (FreeBSD/2.2.8-RELEASE (i386)) Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk In article <22387.915970310@verdi.nethelp.no> you wrote: >> >Precisely. I think that having a reasonably up to date *short* description >> >of each sysctl would be extremely useful. By short I mean 80 characters >> >or less. Yes, I realize that many of the sysctls really need longer >> >descriptions - but short descriptions are still useful! >> >> Most sysctl names already give a useful short description. > I have to at least partly disagree here. Some sysctl names are descriptive, > not all are. I'd argue that many of them aren't *sufficiently* descriptive, > and a short textual description would be helpful. > You and I may know what net.inet.tcp.log_in_vain means - but I think it's > not at all obvious unless you look at the source. I definitely didn't know > what net.inet.ip.fastforwarding was until I looked at the source. And what can be *short* descriptions for *this* two examples such that I may not look at the sources or man pages ? And second question - what is the max length of the sysctl name ? If it is at least 80 chars then the name MUST be self-descriptive (sp. ?). N.Dudorov To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message