From owner-freebsd-doc Tue Apr 24 12: 1: 3 2001 Delivered-To: freebsd-doc@freebsd.org Received: from sj-msg-core-4.cisco.com (sj-msg-core-4.cisco.com [171.71.163.10]) by hub.freebsd.org (Postfix) with ESMTP id 6D4EB37B424; Tue, 24 Apr 2001 12:00:55 -0700 (PDT) (envelope-from bmah@cisco.com) Received: from bmah-freebsd-0.cisco.com (bmah-freebsd-0.cisco.com [171.70.84.42]) by sj-msg-core-4.cisco.com (8.9.3/8.9.1) with ESMTP id MAA03256; Tue, 24 Apr 2001 12:00:59 -0700 (PDT) Received: (from bmah@localhost) by bmah-freebsd-0.cisco.com (8.11.3/8.11.1) id f3OJ0sC03144; Tue, 24 Apr 2001 12:00:54 -0700 (PDT) (envelope-from bmah) Message-Id: <200104241900.f3OJ0sC03144@bmah-freebsd-0.cisco.com> X-Mailer: exmh version 2.3.1 01/19/2001 with nmh-1.0.4 To: Garrett Wollman Cc: bmah@FreeBSD.ORG, doc@FreeBSD.ORG Subject: Re: [RFC] RELNOTESng for 5-CURRENT In-Reply-To: <200104241721.NAA97189@khavrinen.lcs.mit.edu> References: <200104241603.f3OG3AB06290@bmah-freebsd-0.cisco.com> <200104241721.NAA97189@khavrinen.lcs.mit.edu> Comments: In-reply-to Garrett Wollman message dated "Tue, 24 Apr 2001 13:21:42 -0400." From: "Bruce A. Mah" Reply-To: bmah@FreeBSD.ORG 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_-754113091P"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit Date: Tue, 24 Apr 2001 12:00:54 -0700 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org --==_Exmh_-754113091P Content-Type: text/plain; charset=us-ascii If memory serves me right, Garrett Wollman wrote: > < > > I'd very much like to get comments from people. > > Just a comment on the formatting.... The hardware list would look a > lot better if formatted as a table; e.g.: > > Network interfaces > Gigabit Ethernet > Driver Chipset Supports these devices > ti Alteon Tigon 1 Alteon ACEnic, Netgear GA620, > and Tigon 2 3Com 3C985, [...] > sk XaQti XMAC SysKonnect SK-982x and SK-984x > wx Intel 82452 Intel EtherExpress PRO/1000 > > Wireless > Driver Chipset Supports these devices > wi Lucent/Harris Lucent WaveLAN/IEEE, Cabletron > PRISM II RoamAbout 802.11, [...] ...mumble mumble...what is is, not what it looks like...mumble mumble... Seriously, yes, the formatting can use some work. It's going to take a little work to make this happen. I am not sure if the format you suggested is flexible enough to handle some of the cases we need to do, but I have to go off and think about this a bit. > Providing the name of the driver helps new users to know which device > to select in sysinstall when asked for installation media (or disks to > partition) and also makes the document a bit more useful outside the > installation mechanism. That's a somewhat orthogonal goal, but I think it's also a good one. It's a lot easier to do than restructuring (I think)...we can just add the name of the drivers to the existing classes of devices. I think I can do that with a sweep through the document either before or after the first check-in. Thanks for the feedback...much appreciated. Bruce. --==_Exmh_-754113091P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.4 (FreeBSD) Comment: Exmh version 2.2 06/23/2000 iD8DBQE65c1l2MoxcVugUsMRAoOVAJ49Qe6UBZTZSxNpmy3v2Yr3TZ/E/wCfZvAh tmWaE9aD0gohb7eRoxvZxtw= =NwJD -----END PGP SIGNATURE----- --==_Exmh_-754113091P-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message