Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 29 Jul 2001 15:37:49 +0200
From:      Adrian Chadd <adrian@FreeBSD.org>
To:        Greg Lehey <grog@FreeBSD.org>
Cc:        Warner Losh <imp@harmony.village.org>, Brooks Davis <brooks@one-eyed-alien.net>, Mike Smith <msmith@FreeBSD.org>, Peter Wemm <peter@wemm.org>, 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:  <20010729153749.A33613@ywing.creative.net.au>
In-Reply-To: <20010729101642.D68202@wantadilla.lemis.com>; from grog@FreeBSD.org on Sun, Jul 29, 2001 at 10:16:42AM %2B0930
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> <20010729101642.D68202@wantadilla.lemis.com>

next in thread | previous in thread | raw e-mail | index | archive | help
On Sun, Jul 29, 2001, Greg Lehey wrote:
> 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.

We're about to hit the "extract documentation from the sysctl definitions"
request, again .. :-)




Adrian


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?20010729153749.A33613>