Bug 272923

Summary: FreeBSD Handbook 7.4.4.2. Authenticate with Open Networks ifconfig wrong command.
Product: Documentation Reporter: Ramiro Aceves <ea1abz>
Component: Books & ArticlesAssignee: Sergio Carlavilla Delgado <carlavilla>
Status: Closed FIXED    
Severity: Affects Only Me CC: carlavilla
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   
See Also: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=256957

Description Ramiro Aceves 2023-08-03 21:12:19 UTC 
In FreeBSD Handbook
7.4.4.2. Authenticate with Open Networks

Once the wireless network scan is done and the SSID of the wireless network is selected, execute the following command:

# ifconfig wlan0 SSID

I think it should be:

# ifconfig wlan0 ssid SSID

Thanks.
Regards.
Comment 1 Graham Perrin freebsd_committer freebsd_triage 2023-08-04 01:51:13 UTC 
There's a tip: 

> It is important that the user is very careful when connecting to 
> open networks without any kind of authentication.

So, maybe also document the less than careful automated 
connections, by the system, to unwanted open networks.
Comment 2 commit-hook freebsd_committer freebsd_triage 2023-08-04 13:39:58 UTC 
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=54717aa8e64b06539fce6437139dc90223f4a909

commit 54717aa8e64b06539fce6437139dc90223f4a909
Author:     Ed Maste <emaste@FreeBSD.org>
AuthorDate: 2023-08-04 13:37:12 +0000
Commit:     Ed Maste <emaste@FreeBSD.org>
CommitDate: 2023-08-04 13:38:58 +0000

    handbook: correct ifconfig ssid example

    The example requires the literal parameter string "ssid" followed by the
    desired SSID.

    PR:             272923
    Sponsored by:   The FreeBSD Foundation

 documentation/content/en/books/handbook/network/_index.adoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
Comment 3 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2023-08-29 11:22:20 UTC 
Fixed.
Thanks for the report.