Date: Sun, 25 Jun 2000 17:27:28 +0900 From: "Daniel C. Sobral" <dcs@newsguy.com> To: Mike Pritchard <mpp@mppsystems.com> Cc: Peter Wemm <peter@netplex.com.au>, current@FreeBSD.ORG Subject: Re: HEADS UP!: config changes... Message-ID: <3955C270.92B42C6B@newsguy.com> References: <20000613231829.2F4BF1CD7@overcee.netplex.com.au> <20000624183247.A9232@mppsystems.com>
next in thread | previous in thread | raw e-mail | index | archive | help
Mike Pritchard wrote: > > I just noticed that this change has now made a lot of the section 4 > man pages out of date. > > What is the best way to represent these changes in the man pages? > A good example is ata(4). Currently it reads like this: > > SYNOPSIS > device isa > device ata0 at isa? port IO_WD1 irq 14 > device ata1 at isa? port IO_WD2 irq 15 > > Should this become: > > SYNOPSIS > device isa > device ata > hint.ata.0.at="isa" > hint.ata.0.port="0x1F0" > hint.ata.0.irq="14" > hint.ata.1.at="isa" > hint.ata.1.port="0x170" > > Or some much mess? When will the hints file syntax be nailed down, > so that someone can go in and fix all the man pages without having > to worry about having to go through and do it all again when the > syntax changes? > > Something in the loader man pages should be updated to provide info > on the new hints stuff. Having a man page dedicated to describing the > hints stuff probably would also be a good idea to make it easy for people > to figure out how it works. This definitely needs some work. I'm not sure the hints syntax will change much, if at all. OTOH, I don't know how to approach this. In other words, suggestions (and specially patches) are welcome. -- Daniel C. Sobral (8-DCS) dcs@newsguy.com dcs@freebsd.org capo@the.great.underground.bsdconpiracy.org Windows works, for sufficently small values of "works". To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-current" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?3955C270.92B42C6B>