From owner-freebsd-doc@FreeBSD.ORG Fri Aug 8 17:02:34 2003 Return-Path: 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 86A0837B401; Fri, 8 Aug 2003 17:02:34 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7616C43FAF; Fri, 8 Aug 2003 17:02:33 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 8FD3B10BFA8; Sat, 9 Aug 2003 02:02:31 +0200 (CEST) Date: Sat, 9 Aug 2003 02:02:31 +0200 From: "Simon L. Nielsen" To: "Bruce A. Mah" Message-ID: <20030809000230.GA53916@FreeBSD.org> References: <200308082326.h78NQpmh056949@intruder.kitchenlab.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="uAKRQypu60I7Lcqm" Content-Disposition: inline In-Reply-To: <200308082326.h78NQpmh056949@intruder.kitchenlab.org> User-Agent: Mutt/1.5.4i cc: Mark Linimon cc: freebsd-doc@freebsd.org cc: Ruslan Ermilov Subject: Re: Hardware notes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 09 Aug 2003 00:02:35 -0000 --uAKRQypu60I7Lcqm Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable [Ruslan CC'ed since I suggest abusing the manual pages, and he might have comments about that] [Bruce wants to simplify the hardware notes, and mainly make the hardware notes references to the section 4 manual pages] On 2003.08.08 16:26:51 -0700, Bruce A. Mah wrote: > If memory serves me right, Mark Linimon wrote: > > The main problem that I see is that you can't search the document > > (via browser or grep) to see if the blahfoo card is supported. > > I've done that in the past to rule in, or out, something on EBay. >=20 > Yep, that's definitely a problem. I'm not sure how to mitigate this. Perhaps a full text search engine for the manual pages? This could also be useful for as a general tool. I have been thinking a bit about the hardware notes today, and I got a crazy idea... If each section 4 manual page listed the supported devices in some machine parseable way (e.g. in a seperate section?), the device list could actually be extracted from the manual pages and used in the release notes. Then the actual list would only be one place for each driver. While it might sound a bit crazy, I actually think it could work. Of course it would require some work in the manual pages, but it shouldn't be too hard. BTW, in general I like the idea of removing the specifics in the release notes, since duplication is almost always a bad thing, if it can be avoided. --=20 Simon L. Nielsen FreeBSD Documentation Team --uAKRQypu60I7Lcqm Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE/NDoWh9pcDSc1mlERAhSzAJ92ot6fTM3XmZs2nCFoCWYKrveWzQCeOH/e 9zr4HJSmHybcf1E26Kr/5fo= =6MK8 -----END PGP SIGNATURE----- --uAKRQypu60I7Lcqm--