From nobody@FreeBSD.org  Tue Feb  8 13:20:27 2011
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id AC365106566B
	for <freebsd-gnats-submit@FreeBSD.org>; Tue,  8 Feb 2011 13:20:27 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 9D86B8FC19
	for <freebsd-gnats-submit@FreeBSD.org>; Tue,  8 Feb 2011 13:20:27 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p18DKR00005372
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 8 Feb 2011 13:20:27 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id p18DKRob005371;
	Tue, 8 Feb 2011 13:20:27 GMT
	(envelope-from nobody)
Message-Id: <201102081320.p18DKRob005371@red.freebsd.org>
Date: Tue, 8 Feb 2011 13:20:27 GMT
From: Jason Mann <jason.mann@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: ath_hal(4) manpage lists incorrect Netgear adapter as supported
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         154589
>Category:       docs
>Synopsis:       ath_hal(4) manpage lists incorrect Netgear adapter as supported
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    jpaetzel
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Feb 08 13:30:12 UTC 2011
>Closed-Date:    Thu Feb 10 15:42:19 UTC 2011
>Last-Modified:  Thu Feb 10 15:50:12 UTC 2011
>Originator:     Jason Mann
>Release:        8.1-RELEASE
>Organization:
>Environment:
n/a

>Description:
NetGear have produced both a WG311 and a WG311T PCI wireless adapter.  The latter is based on an Atheros AR5212 chip while the former is not.

The ath_hal(4) man page incorrectly lists the NetGear WG311 adapter as being supported by the ath_hal driver, whereas it is the WG311T that should be listed.


>How-To-Repeat:
n/a
>Fix:
Correct the man page by appending 'T' to the NetGear WG311 adapter model name.

>Release-Note:
>Audit-Trail:

From: Josh Paetzel <jpaetzel@freebsd.org>
To: bug-followup@freebsd.org,
 jason.mann@gmail.com
Cc:  
Subject: Re: docs/154589: ath_hal(4) manpage lists incorrect Netgear adapter as supported
Date: Wed, 9 Feb 2011 09:07:23 -0600

 There are three versions of the WG311 now, all using different chipsets.  At 
 the time the manpage was written, there was only one version of the WG311, and 
 it does in fact use an atheros chipset.  Today it is called the WG311v1, and 
 is works with ath.  I believe the v2 is also an atheros and also works with 
 ath.  The v3 is definitely not an atheros though, and isn't supported.  The v3 
 is also what you can buy these days.
 
 The man page is somewhat like a book written about World War One in 1924.
 
 Many of the wireless man pages are in the same shape as this one.  The same 
 product can be based on several chipsets throughout it's lifespan, and 
 oftentimes the man pages reflect the situation that existed when they were 
 written or updated, not the situation as it exists today.
 
 I'd recommend listing the WG311v1 as supported as well as the WG311T, since we 
 know for sure these work.  Perhaps someone with a v2 and v3 can provide input 
 as to their status.
 
 -- 
 Thanks,
 
 Josh Paetzel
 FreeBSD -- The power to serve

From: Jason Mann <jason.mann@gmail.com>
To: Josh Paetzel <jpaetzel@freebsd.org>
Cc: bug-followup@freebsd.org
Subject: Re: docs/154589: ath_hal(4) manpage lists incorrect Netgear adapter
 as supported
Date: Wed, 9 Feb 2011 17:27:54 +0000

 Hi Josh,
 
 I can say with certainty that the WG311v3 isn't supported by ath_hal
 as it was discovering this fact last week that prompted me to
 substitute it for a WG311T and submit this PR.
 
 The WG311v3 adapter actually requires if_malo.ko and is listed in that
 driver's man page.
 
 Here's my relevant dmesg lines for the WG311T:
 
 ath0: <Atheros 5212> mem 0xec000000-0xec00ffff irq 17 at device 10.0 on pci=
 0
 ath0: [ITHREAD]
 ath0: AR2413 mac 7.9 RF2413 phy 4.5
 
 
 Regards,
 
 Jason
 
 
 On 9 February 2011 15:07, Josh Paetzel <jpaetzel@freebsd.org> wrote:
 > There are three versions of the WG311 now, all using different chipsets. =
 =A0At
 > the time the manpage was written, there was only one version of the WG311=
 , and
 > it does in fact use an atheros chipset. =A0Today it is called the WG311v1=
 , and
 > is works with ath. =A0I believe the v2 is also an atheros and also works =
 with
 > ath. =A0The v3 is definitely not an atheros though, and isn't supported. =
 =A0The v3
 > is also what you can buy these days.
 >
 > The man page is somewhat like a book written about World War One in 1924.
 >
 > Many of the wireless man pages are in the same shape as this one. =A0The =
 same
 > product can be based on several chipsets throughout it's lifespan, and
 > oftentimes the man pages reflect the situation that existed when they wer=
 e
 > written or updated, not the situation as it exists today.
 >
 > I'd recommend listing the WG311v1 as supported as well as the WG311T, sin=
 ce we
 > know for sure these work. =A0Perhaps someone with a v2 and v3 can provide=
  input
 > as to their status.
 >
 > --
 > Thanks,
 >
 > Josh Paetzel
 > FreeBSD -- The power to serve
 >
Responsible-Changed-From-To: freebsd-doc->jpaetzel 
Responsible-Changed-By: jpaetzel 
Responsible-Changed-When: Thu Feb 10 00:06:26 UTC 2011 
Responsible-Changed-Why:  
I'll take it 

http://www.freebsd.org/cgi/query-pr.cgi?pr=154589 
State-Changed-From-To: open->closed 
State-Changed-By: jpaetzel 
State-Changed-When: Thu Feb 10 15:41:54 UTC 2011 
State-Changed-Why:  
Committed, thanks. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=154589 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/154589: commit references a PR
Date: Thu, 10 Feb 2011 15:41:39 +0000 (UTC)

 Author: jpaetzel
 Date: Thu Feb 10 15:41:32 2011
 New Revision: 218523
 URL: http://svn.freebsd.org/changeset/base/218523
 
 Log:
   Netgear renamed the WG311 to the WG311v1 after they released a second
   version of it.  There is also a WG311v3 which uses a chipset covered by
   malo(4). Along the way add the WG311T to the list which is also an
   atheros chipset.
   
   PR:	docs/154589
   Approved by:	kib (mentor)
   MFC after:	3 days
 
 Modified:
   head/share/man/man4/ath_hal.4
 
 Modified: head/share/man/man4/ath_hal.4
 ==============================================================================
 --- head/share/man/man4/ath_hal.4	Thu Feb 10 15:07:17 2011	(r218522)
 +++ head/share/man/man4/ath_hal.4	Thu Feb 10 15:41:32 2011	(r218523)
 @@ -109,7 +109,9 @@ module:
  .It "Netgear WAG311	AR5212	PCI	a/b/g"
  .It "Netgear WAB501	AR5211	CardBus	a/b"
  .It "Netgear WAG511	AR5212	CardBus	a/b/g"
 -.It "Netgear WG311	AR5212	PCI	b/g"
 +.It "Netgear WG311 (aka WG311v1)	AR5212	PCI	b/g"
 +.It "Netgear WG311v2	AR5212	PCI	b/g"
 +.It "Netgear WG311T	AR5212	PCI	b/g"
  .It "Netgear WG511T	AR5212	CardBus	b/g"
  .It "Orinoco 8480	AR5212	CardBus	a/b/g"
  .It "Orinoco 8470WD	AR5212	CardBus	a/b/g"
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
>Unformatted:
