From owner-freebsd-doc@FreeBSD.ORG Tue Jun 28 08:59:54 2005 Return-Path: X-Original-To: freebsd-doc@freebsd.org Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 2F47516A41C; Tue, 28 Jun 2005 08:59:54 +0000 (GMT) (envelope-from neuhauser@sigpipe.cz) Received: from isis.sigpipe.cz (fw.sigpipe.cz [62.245.70.224]) by mx1.FreeBSD.org (Postfix) with ESMTP id D504D43D55; Tue, 28 Jun 2005 08:59:53 +0000 (GMT) (envelope-from neuhauser@sigpipe.cz) Received: by isis.sigpipe.cz (Postfix, from userid 1001) id C0B4B1F87BEE; Tue, 28 Jun 2005 10:59:50 +0200 (CEST) Date: Tue, 28 Jun 2005 10:59:50 +0200 From: Roman Neuhauser To: "Simon L. Nielsen" Message-ID: <20050628085950.GA48140@isis.sigpipe.cz> 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> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20050627192042.GD958@zaphod.nitro.dk> User-Agent: Mutt/1.5.9i Cc: freebsd-doc@freebsd.org, John Baldwin , pgabriel@grex.cyberspace.org Subject: Re: docs/80611: Missing items in supported hardware list on your site for FreeSD 4.11 and 5.x X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 28 Jun 2005 08:59:54 -0000 # 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