svn commit: r297330 - head/usr.sbin/pw

[Warren Block]

Author: wblock (doc committer)
Date: Mon Mar 28 02:05:35 2016
New Revision: 297330
URL: https://svnweb.freebsd.org/changeset/base/297330

Log:
  Adjust misleading wording of the -G option and simplify a few
  surrounding sentences.  From a discussion on -ports.
  
  Reviewed by:	David Wolfskill <david at catwhisker.org>

Modified:
  head/usr.sbin/pw/pw.8

Modified: head/usr.sbin/pw/pw.8
==============================================================================
--- head/usr.sbin/pw/pw.8	Sun Mar 27 23:19:21 2016	(r297329)
+++ head/usr.sbin/pw/pw.8	Mon Mar 28 02:05:35 2016	(r297330)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd June 14, 2015
+.Dd March 27, 2016
 .Dt PW 8
 .Os
 .Sh NAME
@@ -420,18 +420,16 @@ Set the account's primary group to the g
 .Ar group
 may be defined by either its name or group number.
 .It Fl G Ar grouplist
-Set additional group memberships for an account.
+Set secondary group memberships for an account.
 .Ar grouplist
-is a comma, space or tab-separated list of group names or group numbers.
-The user's name is added to the group lists in
-.Pa /etc/group ,
-and
-removed from any groups not specified in
-.Ar grouplist .
-Note: a user should not be added to their primary group with
+is a comma, space, or tab-separated list of group names or group numbers.
+The user is added to the groups specified in
+.Ar grouplist ,
+and removed from all groups not specified.
+The current login session is not affected by group membership changes,
+which only take effect when the user reconnects.
+Note: do not add a user to their primary group with
 .Ar grouplist .
-Also, group membership changes do not take effect for current user login
-sessions, requiring the user to reconnect to be affected by the changes.
 .It Fl L Ar class
 This option sets the login class for the user being created.
 See