From owner-freebsd-doc@FreeBSD.ORG Fri Aug 8 16:22:14 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 B203337B401 for ; Fri, 8 Aug 2003 16:22:14 -0700 (PDT) Received: from a.smtp-out.sonic.net (a.smtp-out.sonic.net [208.201.224.38]) by mx1.FreeBSD.org (Postfix) with SMTP id 6CB4243FAF for ; Fri, 8 Aug 2003 16:22:12 -0700 (PDT) (envelope-from bmah@intruder.kitchenlab.org) Received: (qmail 1501 invoked from network); 8 Aug 2003 23:22:11 -0000 Received: from sub.sonic.net (208.201.224.8) by a.smtp-out.sonic.net with SMTP; 8 Aug 2003 23:22:11 -0000 Received: from intruder.kitchenlab.org (adsl-64-142-29-77.sonic.net [64.142.29.77]) by sub.sonic.net (8.11.6p2/8.8.5) with ESMTP id h78NMBx15983; Fri, 8 Aug 2003 16:22:11 -0700 X-envelope-info: Received: from intruder.kitchenlab.org (bmah@localhost [127.0.0.1]) h78NMBmh056880; Fri, 8 Aug 2003 16:22:11 -0700 (PDT) (envelope-from bmah@intruder.kitchenlab.org) Message-Id: <200308082322.h78NMBmh056880@intruder.kitchenlab.org> X-Mailer: exmh version 2.6.3 04/04/2003 with nmh-1.0.4 To: Tom Rhodes In-Reply-To: <20030808123638.592340a0.trhodes@FreeBSD.org> References: <200308081630.h78GU4mh051520@intruder.kitchenlab.org> <20030808123638.592340a0.trhodes@FreeBSD.org> Comments: In-reply-to Tom Rhodes message dated "Fri, 08 Aug 2003 12:36:38 -0400." From: bmah@FreeBSD.org (Bruce A. Mah) X-Face: g~c`.{#4q0"(V*b#g[i~rXgm*w;:nMfz%_RZLma)UgGN&=j`5vXoU^@n5v4:OO)c["!w)nD/!!~e4Sj7LiT'6*wZ83454H""lb{CC%T37O!!'S$S&D}sem7I[A 2V%N&+ X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-Url: http://www.employees.org/~bmah/ Mime-Version: 1.0 Content-Type: multipart/signed; boundary="==_Exmh_-1827877734P"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit Date: Fri, 08 Aug 2003 16:22:11 -0700 Sender: bmah@intruder.kitchenlab.org cc: "Bruce A. Mah" cc: freebsd-doc@FreeBSD.org Subject: Re: Hardware notes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: bmah@FreeBSD.org List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 08 Aug 2003 23:22:15 -0000 --==_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 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--