From dcc944785e97d7fef281f74ec06b1b025acecaea Mon Sep 17 00:00:00 2001
From: bcr <bcr@FreeBSD.org>
Date: Mon, 11 Feb 2019 17:48:52 +0000
Subject: [PATCH] MFC r343921:

Add an example to pw.8 about how to add an existing user to a group.

Instead of using pw to modify group membership, users often edit
/etc/group by hand, which is discouraged.  Provide an example of
adding a user to the wheel group, which is a common use case.
I'm using a different user here as in the previous example as that
deleted the user (although the examples don't necessarily have to
be followed in order).

Reviewed by:	rgrimes,0mp
Approved by:    0mp
Differential Revision:	https://reviews.freebsd.org/D19123
---
 usr.sbin/pw/pw.8 | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/usr.sbin/pw/pw.8 b/usr.sbin/pw/pw.8
index a8304d401ac..cd78850e264 100644
--- a/usr.sbin/pw/pw.8
+++ b/usr.sbin/pw/pw.8
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd December 10, 2017
+.Dd February 8, 2019
 .Dt PW 8
 .Os
 .Sh NAME
@@ -974,6 +974,12 @@ Finally, a random password is generated and displayed:
 .Bd -literal -offset indent
 pw useradd -n gsmith -c "Glurmo Smith" -s /bin/csh -m -w random
 .Ed
+.Pp
+Add the existing user jsmith to the wheel group,
+in addition to the other groups jsmith is already a member of.
+.Bd -literal -offset indent
+pw groupmod wheel -m jsmith
+.Ed
 .Sh EXIT STATUS
 The
 .Nm
-- 
2.45.0