Date: Tue, 28 Jun 2005 10:59:50 +0200 From: Roman Neuhauser <neuhauser@sigpipe.cz> To: "Simon L. Nielsen" <simon@FreeBSD.org> Cc: freebsd-doc@freebsd.org, John Baldwin <jhb@FreeBSD.org>, pgabriel@grex.cyberspace.org Subject: Re: docs/80611: Missing items in supported hardware list on your site for FreeSD 4.11 and 5.x Message-ID: <20050628085950.GA48140@isis.sigpipe.cz> In-Reply-To: <20050627192042.GD958@zaphod.nitro.dk> References: <200506210623.j5L6NR3B004615@freefall.freebsd.org> <20050621063304.GL3346@pcwin002.win.tue.nl> <20050621064402.GP3352@kaiser.sig11.org> <200506211101.09214.jhb@FreeBSD.org> <1119371850.523.16.camel@dude.automatvapen.se> <20050627085729.GA38502@isis.sigpipe.cz> <20050627192042.GD958@zaphod.nitro.dk>
next in thread | previous in thread | raw e-mail | index | archive | help
# simon@FreeBSD.org / 2005-06-27 21:20:43 +0200:
> On 2005.06.27 10:57:29 +0200, Roman Neuhauser wrote:
> > # joel@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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20050628085950.GA48140>