From owner-cvs-all Sat Jul 28 17:46:57 2001 Delivered-To: cvs-all@freebsd.org Received: from wantadilla.lemis.com (wantadilla.lemis.com [192.109.197.80]) by hub.freebsd.org (Postfix) with ESMTP id B74F437B405; Sat, 28 Jul 2001 17:46:44 -0700 (PDT) (envelope-from grog@lemis.com) Received: by wantadilla.lemis.com (Postfix, from userid 1004) id BA2066ACC3; Sun, 29 Jul 2001 10:16:42 +0930 (CST) Date: Sun, 29 Jul 2001 10:16:42 +0930 From: Greg Lehey To: Warner Losh Cc: Brooks Davis , Mike Smith , Peter Wemm , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/sys/conf param.c src/sys/kern subr_param.c kern_mib.c src/sys/sys systm.h Message-ID: <20010729101642.D68202@wantadilla.lemis.com> References: <20010728140844.B27582@Odin.AC.HMC.Edu> <20010727162625.7262738FE@overcee.netplex.com.au> <200107282058.f6SKvwJ02435@mass.dis.org> <20010728140844.B27582@Odin.AC.HMC.Edu> <200107282249.f6SMnLw25589@harmony.village.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <200107282249.f6SMnLw25589@harmony.village.org>; from imp@harmony.village.org on Sat, Jul 28, 2001 at 04:49:21PM -0600 Organization: The FreeBSD Project Phone: +61-8-8388-8286 Fax: +61-8-8388-8725 Mobile: +61-418-838-708 WWW-Home-Page: http://www.FreeBSD.org/ X-PGP-Fingerprint: 6B 7B C3 8C 61 CD 54 AF 13 24 52 F8 6D A4 95 EF Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG On Saturday, 28 July 2001 at 16:49:21 -0600, Warner Losh wrote: > In message <20010728140844.B27582@Odin.AC.HMC.Edu> Brooks Davis writes: >> One suggestion here. It would be nice if this file listed every tunable >> even if they are documented elseware. Just a simple "see pcic(4)" or >> was ever would be nice. That way there's one place to start when you >> go "WTF is this hw.ata.wc thing?" > > Well, there's always: > > hw.ata > see ata(4) > > hw.pcic > see pcic(4) > > hw.something-else > The something else option controls when something happens. It does seem to make sense to have a cross-reference in sysctl(8). I think it needs to be more than this level, too. More like: hw.ata sysctls relating to the ATA driver. See ata(4). hw.ata.ata_dma Control DMA transfers. hw.ata.wc Control write caching hw.ata.tags Control tagged queueing hw.ata.atapi_dma Control DMA for ATAPI CD-ROMs. etc. Just referring to another man page doesn't give an adequate overview. Greg -- See complete headers for address and phone numbers To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message