git: 9692d5e15e9b - main - arswitch.4: Improve title and add HARDWARE

From: Alexander Ziaee <ziaee_at_FreeBSD.org>
Date: Tue, 13 May 2025 17:21:14 UTC
The branch main has been updated by ziaee:

URL: https://cgit.FreeBSD.org/src/commit/?id=9692d5e15e9bd7e628b06d655522477ce8c5b6fe

commit 9692d5e15e9bd7e628b06d655522477ce8c5b6fe
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2025-05-12 01:37:17 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2025-05-13 17:20:37 +0000

    arswitch.4: Improve title and add HARDWARE
    
    For visibility in apropos and inclusion in the hardware release notes.
    
    MFC after:              3 days
    Reviewed by:            adrian (previous), mhorne
    Approved by:            mhorne
---
 share/man/man4/arswitch.4 | 35 +++++++++++++++++++++--------------
 1 file changed, 21 insertions(+), 14 deletions(-)

diff --git a/share/man/man4/arswitch.4 b/share/man/man4/arswitch.4
index 3ec7316ae6e7..5bcd6c6810ee 100644
--- a/share/man/man4/arswitch.4
+++ b/share/man/man4/arswitch.4
@@ -22,12 +22,12 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd August 8, 2023
+.Dd May 11, 2025
 .Dt ARSWITCH 4
 .Os
 .Sh NAME
 .Nm arswitch
-.Nd driver for Atheros Fast Ethernet switch
+.Nd Atheros AR8000 series Ethernet switch driver
 .Sh SYNOPSIS
 .Cd "device mdio"
 .Cd "device etherswitch"
@@ -35,18 +35,8 @@
 .Sh DESCRIPTION
 The
 .Nm
-device driver provides a management interface to multiple Atheros
-fast ethernet switch chips:
-.Bl -tag -compact -width "AR8216"
-.It AR8216
-Fast Ethernet Switch
-.It AR8226
-.It AR8316
-Six-port Gigabit Ethernet Switch
-.It AR8327
-Seven-port Gigabit Ethernet Switch
-.El
-.Pp
+driver provides a management interface to Atheros AR8000 series Ethernet
+switch controllers.
 The driver uses an
 .Xr mdio 4
 or
@@ -70,6 +60,23 @@ and
 are mutually exclusive.
 .Pp
 Setting the switch MAC address is not supported.
+.Sh HARDWARE
+The
+.Nm
+driver supports the following Ethernet switch controllers:
+.Pp
+.Bl -bullet -compact
+.It
+Atheros AR8327 Seven-port Gigabit Ethernet Switch
+.It
+Atheros AR8316 Six-port Gigabit Ethernet Switch
+.It
+Atheros AR8236 Six-port Fast Ethernet Switch
+.It
+Atheros AR8226 Six-port Fast Ethernet Switch
+.It
+Atheros AR8216 Six-port Fast Ethernet Switch
+.El
 .Sh SEE ALSO
 .Xr etherswitch 4 ,
 .Xr etherswitchcfg 8