git: 4c66fafd6b29 - stable/13 - pw: make manual page more friendly for uid/gid search

The branch stable/13 has been updated by marck:

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

commit 4c66fafd6b29e306184ff3bd1bcd6c8f4a29f11c
Author:     Dmitry Morozovsky <marck@FreeBSD.org>
AuthorDate: 2026-02-11 19:34:00 +0000
Commit:     Dmitry Morozovsky <marck@FreeBSD.org>
CommitDate: 2026-02-18 09:50:59 +0000

    pw: make manual page more friendly for uid/gid search
    
    pw.8 structure is quite different from usual manual page, especially in
    describing -o option usage.  Specifically, these paragraphs do not
    contain "uid/gid" terms, and have "user id"/"group id" instead,
    making searching for "override duplicate safety belt" difficult.
    Try to simplify such searches.
    
    Also, clarify uid/gid space between 100 and 1000 as "somewhat special",
    as it actually is.
    
    Discussed on:   russian telegram FreeBSD group
    Reviewed by:    eugen, novel
    MFC after:      1 week
    
    (cherry picked from commit e89454417b2bfecce9daee10dece2f49632640d3)
---
 usr.sbin/pw/pw.8 | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/usr.sbin/pw/pw.8 b/usr.sbin/pw/pw.8
index 5ba35c193811..9bbb05ae0082 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 November 28, 2022
+.Dd February 11, 2026
 .Dt PW 8
 .Os
 .Sh NAME
@@ -551,8 +551,8 @@ It is possible to use
 to create a new account that duplicates an existing user id.
 While this is normally considered an error and will be rejected, the
 .Fl o
-option overrides the check for duplicates and allows the duplication of
-the user id.
+option overrides the check for uniqueness and allows the duplication of
+the uid.
 This may be useful if you allow the same user to login under
 different contexts (different group allocations, different home
 directory, different shell) while providing basically the same
@@ -665,6 +665,9 @@ In general,
 user and group ids less than 100 are reserved for use by the system,
 and numbers greater than 32000 may also be reserved for special purposes
 .Pq used by some system daemons .
+Also, uids and gids between 100 and 999 are commonly used by pseudo-users
+assotiated with third-party programs, and generally should be avoided for
+assigning for normal users.
 .It Fl w Ar passmethod
 The
 .Fl w
@@ -864,7 +867,7 @@ also has a
 option that allows allocation of an existing group id to a new group.
 The default action is to reject an attempt to add a group,
 and this option overrides the check for duplicate group ids.
-There is rarely any need to duplicate a group id.
+There is rarely any need to duplicate a gid.
 .Pp
 The
 .Cm groupmod