git: 545dbf9d5fad - main - iwn.4: move hardware to HARDWARE + minor cleanup

From: Bjoern A. Zeeb <bz_at_FreeBSD.org>
Date: Thu, 17 Oct 2024 19:48:48 UTC
The branch main has been updated by bz:

URL: https://cgit.FreeBSD.org/src/commit/?id=545dbf9d5fadfab591350c7c504b8e4bd113ba7b

commit 545dbf9d5fadfab591350c7c504b8e4bd113ba7b
Author:     Alexander Ziaee <concussious@runbox.com>
AuthorDate: 2024-10-17 19:29:34 +0000
Commit:     Bjoern A. Zeeb <bz@FreeBSD.org>
CommitDate: 2024-10-17 19:48:16 +0000

    iwn.4: move hardware to HARDWARE + minor cleanup
    
    Add devices supported by this driver to a HARDWARE section
    for inclusion in the release Hardware Compatibility Notes.
    While here:
    - add SPDX tag
    - add networking(7) cross-ref quick start guide
    - tweak examples for consistency
    
    MFC after:      3 days
    Differential Revision: https://reviews.freebsd.org/D47168
---
 share/man/man4/iwn.4 | 106 +++++++++++++++++++++++++++++++++------------------
 1 file changed, 68 insertions(+), 38 deletions(-)

diff --git a/share/man/man4/iwn.4 b/share/man/man4/iwn.4
index 1d9f50c38fee..55692a5386a5 100644
--- a/share/man/man4/iwn.4
+++ b/share/man/man4/iwn.4
@@ -1,3 +1,6 @@
+.\"-
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
 .\" Copyright (c) 2004-2006
 .\"	Damien Bergamini <damien.bergamini@free.fr>. All rights reserved.
 .\"
@@ -23,7 +26,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd May 30, 2021
+.Dd October 17, 2024
 .Dt IWN 4
 .Os
 .Sh NAME
@@ -87,38 +90,7 @@ iwn6050fw_load="YES"
 .Sh DESCRIPTION
 The
 .Nm
-driver provides support for:
-.Pp
-.Bl -tag -width Ds -offset indent -compact
-.It Intel Centrino Advanced-N 6200
-.It Intel Centrino Advanced-N 6205
-.It Intel Centrino Advanced-N 6230
-.It Intel Centrino Advanced-N 6235
-.It Intel Centrino Advanced-N + WiMAX 6250
-.It Intel Centrino Ultimate-N 6300
-.It Intel Centrino Wireless-N 100
-.It Intel Centrino Wireless-N 105
-.It Intel Centrino Wireless-N 130
-.It Intel Centrino Wireless-N 135
-.It Intel Centrino Wireless-N 1000
-.It Intel Centrino Wireless-N 1030
-.It Intel Centrino Wireless-N 2200
-.It Intel Centrino Wireless-N 2230
-.It Intel Centrino Wireless-N 4965
-.It Intel Centrino Wireless-N 5100
-.It Intel Centrino Wireless-N 6150
-.It Intel Centrino Wireless-N 6200
-.It Intel Centrino Wireless-N 6250
-.It Intel Centrino Wireless-N + WiMAX 6150
-.It Intel Ultimate N WiFi Link 5300
-.It Intel Wireless WiFi Link 4965
-.It Intel WiFi Link 5100
-.It Intel WiMAX/WiFi Link 5150
-.It Intel WiMAX/WiFi Link 5350
-.El
-.Pp
-.Nm
-supports
+driver supports
 .Cm station
 and
 .Cm monitor
@@ -130,27 +102,84 @@ For more information on configuring this device, see
 This driver requires the firmware built with the
 .Nm iwnfw
 module to work.
+.Sh HARDWARE
+The
+.Nm
+driver provides support for:
+.Pp
+.Bl -bullet -compact
+.It
+Intel Centrino Advanced-N 6200
+.It
+Intel Centrino Advanced-N 6205
+.It
+Intel Centrino Advanced-N 6230
+.It
+Intel Centrino Advanced-N 6235
+.It
+Intel Centrino Advanced-N + WiMAX 6250
+.It
+Intel Centrino Ultimate-N 6300
+.It
+Intel Centrino Wireless-N 100
+.It
+Intel Centrino Wireless-N 105
+.It
+Intel Centrino Wireless-N 130
+.It
+Intel Centrino Wireless-N 135
+.It
+Intel Centrino Wireless-N 1000
+.It
+Intel Centrino Wireless-N 1030
+.It
+Intel Centrino Wireless-N 2200
+.It
+Intel Centrino Wireless-N 2230
+.It
+Intel Centrino Wireless-N 4965
+.It
+Intel Centrino Wireless-N 5100
+.It
+Intel Centrino Wireless-N 6150
+.It
+Intel Centrino Wireless-N 6200
+.It
+Intel Centrino Wireless-N 6250
+.It
+Intel Centrino Wireless-N + WiMAX 6150
+.It
+Intel Ultimate N WiFi Link 5300
+.It
+Intel Wireless WiFi Link 4965
+.It
+Intel WiFi Link 5100
+.It
+Intel WiMAX/WiFi Link 5150
+.It
+Intel WiMAX/WiFi Link 5350
+.El
 .Sh EXAMPLES
 Join an existing BSS network (i.e., connect to an access point):
 .Bd -literal -offset indent
-ifconfig wlan create wlandev iwn0 inet 192.168.0.20 \e
+# ifconfig wlan create wlandev iwn0 inet 192.168.0.20 \e
     netmask 0xffffff00
 .Ed
 .Pp
 Join a specific BSS network with network name
-.Dq Li my_net :
+.Ql my_net :
 .Pp
-.Dl "ifconfig wlan create wlandev iwn0 ssid my_net up"
+.Dl # ifconfig wlan create wlandev iwn0 ssid my_net up
 .Pp
 Join a specific BSS network with 64-bit WEP encryption:
 .Bd -literal -offset indent
-ifconfig wlan create wlandev iwn0 ssid my_net \e
+# ifconfig wlan create wlandev iwn0 ssid my_net \e
 	wepmode on wepkey 0x1234567890 weptxkey 1 up
 .Ed
 .Pp
 Join a specific BSS network with 128-bit WEP encryption:
 .Bd -literal -offset indent
-ifconfig wlan create wlandev iwn0 wlanmode adhoc ssid my_net \e
+# ifconfig wlan create wlandev iwn0 wlanmode adhoc ssid my_net \e
     wepmode on wepkey 0x01020304050607080910111213 weptxkey 1
 .Ed
 .Sh DIAGNOSTICS
@@ -191,6 +220,7 @@ This should not happen.
 .Xr wlan_ccmp 4 ,
 .Xr wlan_tkip 4 ,
 .Xr wlan_wep 4 ,
+.Xr networking 7 ,
 .Xr ifconfig 8 ,
 .Xr wpa_supplicant 8
 .Sh AUTHORS