git: fb144a705792 - main - pw(8): Brace the name-or-id synopsis so it matches the code

From: Devin Teske <dteske_at_FreeBSD.org>
Date: Mon, 07 Sep 2026 08:03:07 UTC
The branch main has been updated by dteske:

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

commit fb144a705792dcc154ad2f75dfa21fbda255913d
Author:     Devin Teske <dteske@FreeBSD.org>
AuthorDate: 2026-09-07 08:00:47 +0000
Commit:     Devin Teske <dteske@FreeBSD.org>
CommitDate: 2026-09-07 08:00:47 +0000

    pw(8): Brace the name-or-id synopsis so it matches the code
    
    An unbraced pipe list made -n look like it could take a uid (or gid).
    Use braces for a single choice of name or id, and keep -u newuid /
    -g newgid on the name invocation only. Drop the USER/GROUP OPTIONS
    sentences that said -n could be a numeric id.
    
    PR:     269193
    MFC after:      3 days
    Reviewed by:    bapt
    Differential Revision:  https://reviews.freebsd.org/D59472
---
 usr.sbin/pw/pw.8 | 25 +++++++++----------------
 1 file changed, 9 insertions(+), 16 deletions(-)

diff --git a/usr.sbin/pw/pw.8 b/usr.sbin/pw/pw.8
index 1498f76fd9c5..86901c0be4a5 100644
--- a/usr.sbin/pw/pw.8
+++ b/usr.sbin/pw/pw.8
@@ -22,7 +22,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd April 19, 2026
+.Dd September 6, 2026
 .Dt PW 8
 .Os
 .Sh NAME
@@ -75,14 +75,14 @@
 .Op Fl R Ar rootdir
 .Op Fl V Ar etcdir
 .Cm userdel
-.Oo Fl n Oc Ar name Ns | Ns Oo Fl u Oc Ar uid
+.Bro Oo Fl n Oc Ar name | Oo Fl u Oc Ar uid Brc
 .Op Fl r
 .Op Fl Y Op Fl y Ar nispasswd
 .Nm
 .Op Fl R Ar rootdir
 .Op Fl V Ar etcdir
 .Cm usermod
-.Oo Fl n Oc Ar name Ns | Ns Ar uid Oo Fl u Ar newuid Oc | Fl u Ar uid
+.Bro Oo Fl n Oc Ar name Oo Fl u Ar newuid Oc | Oo Fl u Oc Ar uid Brc
 .Op Fl mNPq
 .Op Fl C Ar config
 .Op Fl c Ar comment
@@ -104,7 +104,7 @@
 .Op Fl R Ar rootdir
 .Op Fl V Ar etcdir
 .Cm usershow
-.Oo Fl n Oc Ar name Ns | Ns Oo Fl u Oc Ar uid
+.Bro Oo Fl n Oc Ar name | Oo Fl u Oc Ar uid Brc
 .Op Fl 7aFP
 .Nm
 .Op Fl R Ar rootdir
@@ -127,13 +127,13 @@
 .Op Fl R Ar rootdir
 .Op Fl V Ar etcdir
 .Cm groupdel
-.Oo Fl n Oc Ar name Ns | Ns Oo Fl g Oc Ar gid
+.Bro Oo Fl n Oc Ar name | Oo Fl g Oc Ar gid Brc
 .Op Fl Y
 .Nm
 .Op Fl R Ar rootdir
 .Op Fl V Ar etcdir
 .Cm groupmod
-.Oo Fl n Oc Ar name Ns | Ns Ar gid Oo Fl g Ar newgid Oc | Fl g Ar gid
+.Bro Oo Fl n Oc Ar name Oo Fl g Ar newgid Oc | Oo Fl g Oc Ar gid Brc
 .Op Fl NPqY
 .Op Fl C Ar config
 .Op Fl d Ar oldmembers
@@ -146,7 +146,7 @@
 .Op Fl R Ar rootdir
 .Op Fl V Ar etcdir
 .Cm groupshow
-.Oo Fl n Oc Ar name Ns | Ns Oo Fl g Oc Ar gid
+.Bro Oo Fl n Oc Ar name | Oo Fl g Oc Ar gid Brc
 .Op Fl aFP
 .Nm
 .Op Fl R Ar rootdir
@@ -158,14 +158,14 @@
 .Op Fl R Ar rootdir
 .Op Fl V Ar etcdir
 .Cm lock
-.Oo Fl n Oc Ar name Ns | Ns Oo Fl u Oc Ar uid
+.Bro Oo Fl n Oc Ar name | Oo Fl u Oc Ar uid Brc
 .Op Fl q
 .Op Fl C Ar config
 .Nm
 .Op Fl R Ar rootdir
 .Op Fl V Ar etcdir
 .Cm unlock
-.Oo Fl n Oc Ar name Ns | Ns Oo Fl u Oc Ar uid
+.Bro Oo Fl n Oc Ar name | Oo Fl u Oc Ar uid Brc
 .Op Fl q
 .Op Fl C Ar config
 .Sh DESCRIPTION
@@ -322,10 +322,6 @@ Required unless
 .Fl u Ar uid
 is given.
 Specify the user/account name.
-In the case of
-.Cm usermod
-can be a
-.Ar uid .
 .It Fl u Ar uid
 Required if
 .Ar name
@@ -835,9 +831,6 @@ Required unless
 .Fl g Ar gid
 is given.
 Specify the group name.
-In the case of
-.Cm groupmod
-can be a gid.
 .It Fl g Ar gid
 Required if
 .Ar name