Date: Sat, 9 Aug 2003 02:02:31 +0200 From: "Simon L. Nielsen" <simon@FreeBSD.org> To: "Bruce A. Mah" <bmah@freebsd.org> Cc: Ruslan Ermilov <ru@FreeBSD.org> Subject: Re: Hardware notes Message-ID: <20030809000230.GA53916@FreeBSD.org> In-Reply-To: <200308082326.h78NQpmh056949@intruder.kitchenlab.org> References: <Pine.LNX.4.44.0308081232001.28480-100000@pancho> <200308082326.h78NQpmh056949@intruder.kitchenlab.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030809000230.GA53916>