NetBSD Problem Report #39428

From riastradh@smalltalk.localdomain  Fri Aug 29 05:02:28 2008
Return-Path: <riastradh@smalltalk.localdomain>
Received: from mail.netbsd.org (mail.netbsd.org [204.152.190.11])
	by narn.NetBSD.org (Postfix) with ESMTP id BD45063BC30
	for <gnats-bugs@gnats.NetBSD.org>; Fri, 29 Aug 2008 05:02:27 +0000 (UTC)
Message-Id: <20080829050220.6CDFD6A@smalltalk.localdomain>
Date: Fri, 29 Aug 2008 05:02:20 +0000 (UTC)
From: Taylor R Campbell <campbell@mumble.net>
Reply-To: Taylor R Campbell <campbell@mumble.net>
To: gnats-bugs@gnats.NetBSD.org
Subject: wpa_supplicant.conf(5) describes `ap_scan' option vaguely
X-Send-Pr-Version: 3.95

>Number:         39428
>Category:       bin
>Synopsis:       wpa_supplicant.conf(5) describes `ap_scan' option vaguely
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    bin-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Fri Aug 29 05:05:01 +0000 2008
>Last-Modified:  Fri Aug 29 05:15:07 +0000 2008
>Originator:     Taylor R Campbell <campbell@mumble.net>
>Release:        NetBSD 4.0_STABLE
>Organization:
>Environment:
System: NetBSD smalltalk.localdomain 4.0_STABLE NetBSD 4.0_STABLE (RIAXEN3_DOM0) #4: Sat Aug 23 06:25:39 UTC 2008 riastradh@smalltalk.localdomain:/home/riastradh/netbsd/4/obj/sys/arch/i386/compile/RIAXEN3_DOM0 i386
Architecture: i386
Machine: i386
>Description:

	Quoth wpa_supplicant.conf(5) on the `ap_scan' option:

		Access point scanning and selection control; one of 0,
		1 (default), or 2.  Only setting 1 should be used with
		the wlan(4) module; the other settings are for use on
		other operating systems.

	Presumably the reference to wlan(4) is an artefact of Linux,
	which is undoubtedly the reference point of `other operating
	systems', and should be omitted.  The rest of the description
	is as non-descriptive as one could imagine.  Either the option
	should be omitted altogether, if NetBSD is excluded from `other
	operating systems', or the description should describe the
	option's effects, particularly in a more user-visible manner
	than doc/driver_wrapper.doxygen.

	P.S.  So trivial that I could not bear to file another PR for
	it: there is a missing full stop at the end of line 257
	(one-based):

		Note that by default wpa_supplicant(8) is compiled with
		EAP support

>How-To-Repeat:

	Type `man wpa_supplicant.conf', and try to make sense of the
	`ap_scan' option.

>Fix:

	Once I understand the wpa_supplicant code well enough to
	explain what `ap_scan' actually affects, I'll suggest a patch,
	if no one else beats me to it.

	P.S.  Add a full stop to line 257.

>Audit-Trail:
From: "David A. Holland" <dholland@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/39428 CVS commit: src/usr.sbin/wpa/wpa_supplicant
Date: Fri, 29 Aug 2008 05:10:26 +0000 (UTC)

 Module Name:	src
 Committed By:	dholland
 Date:		Fri Aug 29 05:10:26 UTC 2008

 Modified Files:
 	src/usr.sbin/wpa/wpa_supplicant: wpa_supplicant.conf.5

 Log Message:
 Fix typo; noted by Taylor R Campbell in PR bin/39428.


 To generate a diff of this commit:
 cvs rdiff -r1.3 -r1.4 src/usr.sbin/wpa/wpa_supplicant/wpa_supplicant.conf.5

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

From: David Holland <dholland-bugs@netbsd.org>
To: gnats-bugs@NetBSD.org
Cc: gnats-admin@netbsd.org, netbsd-bugs@netbsd.org
Subject: Re: bin/39428: wpa_supplicant.conf(5) describes `ap_scan' option
	vaguely
Date: Fri, 29 Aug 2008 05:11:11 +0000

 On Fri, Aug 29, 2008 at 05:05:01AM +0000, Taylor R Campbell wrote:
  > 	P.S.  So trivial that I could not bear to file another PR for
  > 	it: there is a missing full stop at the end of line 257
  > 	(one-based):
  > 
  > 		Note that by default wpa_supplicant(8) is compiled with
  > 		EAP support

 This part at least is easily fixed.

 -- 
 David A. Holland
 dholland@netbsd.org

Home	PR Database Search