docs/80611: Missing items in supported hardware list on your site for FreeSD 4.11 and 5.x

[Roman Neuhauser]

# simon at FreeBSD.org / 2005-06-27 21:20:43 +0200:
> On 2005.06.27 10:57:29 +0200, Roman Neuhauser wrote:
> > # joel at automatvapen.se / 2005-06-21 18:37:30 +0200:
> > > On Tue, 2005-06-21 at 11:01 -0400, John Baldwin wrote:
> > > > Aren't the hardware notes supposed to be generated from the man pages for most 
> > > > drivers now?  If ata's man page isn't being used to generate the hardware 
> > > > notes for ata(4) then perhaps the PR should be reopened with the goal of 
> > > > fixing that.
> > > 
> > > I've discussed this with simon and brueffer, and I have a patch that:
> > > 
> > > 1.  Adds a standard HARDWARE section to the ata(4) manual page.
> > > 2.  Makes the hardware notes use the ata(4) manual page for automatic
> > > generation.
> > > 3.  Adds a bunch of supported chipsets that's missing in the ata(4)
> > > manual page.
> > > 
> > > I'm not going to commit it however.
> > 
> >     Out of curiosity: why not?

    [edited]

> The main problem here is, what exactly is worth documenting?
> I see the follow options:
 
> - Document all supported chipsets.
> - Document all supported motherboards and cards.

> As you probably see neither option is really good, which is why
> nothing has really been done about it.

> Basically I'm not really sure what's the best thing to do and neither
> are the people I have disussed this with, e.g. brueffer and joeld.
> Hence the current status-quo.

    Is the current state better than either of the two options?
    (I'd prefer the first one personally, BTW.)

-- 
How many Vietnam vets does it take to screw in a light bulb?
You don't know, man.  You don't KNOW.
Cause you weren't THERE.             http://bash.org/?255991