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)
[EMAIL PROTECTED]
[EMAIL PROTECTED]
[EMAIL PROTECTED]
Windows works, for sufficently small values of "works".
To Unsubscribe: send mail to [EMAIL PROTECTED]
with "unsubscribe freebsd-current" in the body of the message