Date: Fri, 08 Aug 2003 16:22:11 -0700 From: bmah@FreeBSD.org (Bruce A. Mah) To: Tom Rhodes <trhodes@FreeBSD.org> Cc: freebsd-doc@FreeBSD.org Subject: Re: Hardware notes Message-ID: <200308082322.h78NMBmh056880@intruder.kitchenlab.org> In-Reply-To: <20030808123638.592340a0.trhodes@FreeBSD.org> References: <200308081630.h78GU4mh051520@intruder.kitchenlab.org> <20030808123638.592340a0.trhodes@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--==_Exmh_-1827877734P Content-Type: text/plain; charset=us-ascii If memory serves me right, Tom Rhodes wrote: [Bruce wants to eviscerate the hardware notes] > My thoughts on this, which have been kicked around over and over again > in my mind, are similar. My idea was: > > List class > List description (small) > Tell user to review said manual page. > Plea to developers/manual page authors to list supported devices > in the appropriate manual page. > > This would perhaps make it easier for users to figure out if their > devices are supported or not. I'm presuming we don't have to "talk to the users" for every single device. Putting that information up front is probably sufficient. > > A disadvantage is that if someone has a random device (where they don't > > know anything about it other than its name), it's not immediately > > obvious what driver would support it. Perhaps more descriptive > > annotations would help here. > > Where I put (small) for the description, you could list that: > > USB Devices > umass(4) > Driver for USB mass storage devices, zip drives, USB hard drives, etc. > > Or perhaps this could be the other way around: > > USB Devices: > Mass storage, zip drives, USB hard drives, etc. > See the umass(4) manual page for a complete description. Either one of those. Actually the existing format we have now *mostly* works once you take out all of the <itemizedlist></itemizedlist> thingeys. > > > > Thoughts? > > See above, perhaps you and I are on a different wavelink but this > sounds like a good idea which should be fleshed out. I think we're closer than you think. :-) Bruce. --==_Exmh_-1827877734P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) Comment: Exmh version 2.5+ 20020506 iD8DBQE/NDCi2MoxcVugUsMRAjx4AKCSFLLxFGi5cIrlGMDfu2FGgXQkpwCdEf5s iNaNG9sj8piyLItBzGhFVpo= =86if -----END PGP SIGNATURE----- --==_Exmh_-1827877734P--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200308082322.h78NMBmh056880>