cvs commit: src/share/man/man4 ath.4

Bruce A. Mah bmah at freebsd.org
Fri May 12 16:20:33 UTC 2006


If memory serves me right, Giorgos Keramidas wrote:
> keramida    2006-05-12 12:55:56 UTC
> 
>   FreeBSD src repository (doc committer)
> 
>   Modified files:
>     share/man/man4       ath.4 
>   Log:
>   After a mini-discussion with Sam Leffler, remove the hardcoded
>   list of Atheros-based cards from ath(4).  The online list is
>   always more up to date, anyway.
>   
>   This invalidates:
>   
>   PR:             docs/95360  http://www.FreeBSD.org/cgi/query-pr.cgi?pr=95360
>   Submitted by:   Erik Nordstr:om Andersen <erik at erik-n-andersen.dk>

Without expressing any opinion about the removal of this information:
This commit makes the hardware notes look rather odd.  (Remember that
the hardware notes are partially generated from manpages.)  Here's the
entry for ath(4), as well as the the entry that immediately precedes it:

   Cards supported by the cnw(4) driver include:

     * Xircom CreditCard Netwave

     * NetWave AirSurfer

   A list of cards that are supported can be found at
   http://customerproducts.atheros.com/customerproducts. The ath(4)
   driver supports all Atheros Cardbus or PCI cards, except those
   that are based on the AR5005VL chipset.

It's not clear to me whether it'd be better to reword the above
sentences in the manpage to make them more suitable for "dual use", or
if it'd be better to hard-code some appropriate text into the hardware
notes.  (In any case, please keep the Web pointer in the hardware notes
if possible.)

Cheers,

Bruce.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 249 bytes
Desc: OpenPGP digital signature
Url : http://lists.freebsd.org/pipermail/cvs-src/attachments/20060512/4f22e554/signature.pgp


More information about the cvs-src mailing list