bin/39428: wpa_supplicant.conf(5) describes `ap_scan' option vaguely

[Taylor R Campbell <campbell%mumble.net@localhost>]

>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
>Originator:     Taylor R Campbell <campbell%mumble.net@localhost>
>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@localhost:/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.