Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 24 Apr 2001 12:00:54 -0700
From:      "Bruce A. Mah" <bmah@FreeBSD.ORG>
To:        Garrett Wollman <wollman@khavrinen.lcs.mit.edu>
Cc:        bmah@FreeBSD.ORG, doc@FreeBSD.ORG
Subject:   Re: [RFC] RELNOTESng for 5-CURRENT 
Message-ID:  <200104241900.f3OJ0sC03144@bmah-freebsd-0.cisco.com>
In-Reply-To: <200104241721.NAA97189@khavrinen.lcs.mit.edu> 
References:  <200104241603.f3OG3AB06290@bmah-freebsd-0.cisco.com> <200104241721.NAA97189@khavrinen.lcs.mit.edu>

next in thread | previous in thread | raw e-mail | index | archive | help
--==_Exmh_-754113091P
Content-Type: text/plain; charset=us-ascii

If memory serves me right, Garrett Wollman wrote:
> <<On Tue, 24 Apr 2001 09:03:10 -0700, bmah@FreeBSD.ORG (Bruce A. Mah) said:
> 
> > 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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200104241900.f3OJ0sC03144>