git: 36782aaba4f1 - main - wlanstats: update usage, improve man page

From: Bjoern A. Zeeb <bz_at_FreeBSD.org>
Date: Fri, 14 Mar 2025 21:06:46 UTC
The branch main has been updated by bz:

URL: https://cgit.FreeBSD.org/src/commit/?id=36782aaba4f1a7d054aa405357a8fa2bc0f94eb0

commit 36782aaba4f1a7d054aa405357a8fa2bc0f94eb0
Author:     Ceri Davies <ceri@FreeBSD.org>
AuthorDate: 2025-03-14 20:49:39 +0000
Commit:     Bjoern A. Zeeb <bz@FreeBSD.org>
CommitDate: 2025-03-14 21:04:51 +0000

    wlanstats: update usage, improve man page
    
    wlanstats prints the wrong usage statement, including a nonexistent -a
    flag (*) and a description of -m that suggests multiple arguments.
    Make the manpage slightly more clear.
    
    (*) the implementation of that is #if 0 and the option was disabled
        in 530c13c5401c.
    
    Sponsored by:   The FreeBSD Foundation (commit)
    PR:             285413
    MFC after:      3 days
    Reviewed by:    ziaee
    Differential Revision: https://reviews.freebsd.org/D49365
---
 usr.sbin/wlanstats/main.c      |  2 +-
 usr.sbin/wlanstats/wlanstats.8 | 19 +++++++++----------
 2 files changed, 10 insertions(+), 11 deletions(-)

diff --git a/usr.sbin/wlanstats/main.c b/usr.sbin/wlanstats/main.c
index ac100a70622e..85d10ad9012a 100644
--- a/usr.sbin/wlanstats/main.c
+++ b/usr.sbin/wlanstats/main.c
@@ -158,7 +158,7 @@ static void
 usage(void)
 {
 
-	printf("wlanstats: [-ah] [-i ifname] [-l] [-m station MAC address] [-o fmt] [interval]\n");
+	printf("wlanstats: [-h] [-i ifname] [-l] [-m station_MAC_address] [-o fmt] [interval]\n");
 }
 
 int
diff --git a/usr.sbin/wlanstats/wlanstats.8 b/usr.sbin/wlanstats/wlanstats.8
index e032835bac43..a8127726dd61 100644
--- a/usr.sbin/wlanstats/wlanstats.8
+++ b/usr.sbin/wlanstats/wlanstats.8
@@ -6,7 +6,7 @@
 .\"
 .\" SPDX-License-Identifier: BSD-2-Clause
 .\"
-.Dd February 20, 2025
+.Dd March 14, 2025
 .Dt WLANSTATS 8
 .Os
 .Sh NAME
@@ -14,11 +14,10 @@
 .Nd query 802.11 wireless network statistics
 .Sh SYNOPSIS
 .Nm
-.\" .Op Fl a
 .Op Fl h
 .Op Fl i Ar ifnet
 .Op Fl l
-.Op Fl m Ar station MAC address
+.Op Fl m Ar station_MAC_address
 .Op Fl o Ar fmt
 .Op interval
 .Sh DESCRIPTION
@@ -44,19 +43,19 @@ Report information for the specified
 instead of the default
 .Em wlan0 .
 .It Fl l
-List all fields names and their descriptions.
-.It Fl m Ar station MAC address
+List all field names and their descriptions.
+.It Fl m Ar station_MAC_address
 Request information for the station specified by the given
-.Ar MAC address.
+.Ar MAC_address .
 .It Fl o Ar fmt
 Set format of fields to query.
-This can be either on of the pre-defined tags:
+This can be either a pre-defined tag (one of
 .Em default ,
-.Em ampdu , or
-.Em amsdu
+.Em ampdu ,
+or
+.Em amsdu ) ,
 or a comma separated list of field names without space.
 .El
-.Pp
 .Sh SEE ALSO
 .Xr ifconfig 8 ,
 .Xr wlandebug 8