svn commit: r298850 - stable/10/usr.sbin/pw

[Warren Block]

Author: wblock (doc committer)
Date: Sat Apr 30 14:47:45 2016
New Revision: 298850
URL: https://svnweb.freebsd.org/changeset/base/298850

Log:
  MFC r298525:
  
  Add a single example of adding a user that roughly corresponds with the
  adduser example in the Handbook.

Modified:
  stable/10/usr.sbin/pw/pw.8
Directory Properties:
  stable/10/   (props changed)

Modified: stable/10/usr.sbin/pw/pw.8
==============================================================================
--- stable/10/usr.sbin/pw/pw.8	Sat Apr 30 14:43:42 2016	(r298849)
+++ stable/10/usr.sbin/pw/pw.8	Sat Apr 30 14:47:45 2016	(r298850)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd March 27, 2016
+.Dd April 23, 2016
 .Dt PW 8
 .Os
 .Sh NAME
@@ -954,6 +954,18 @@ Pw default options file
 .It Pa /var/log/userlog
 User/group modification logfile
 .El
+.Sh EXAMPLES
+Add new user Glurmo Smith (gsmith).
+A gsmith login group is created if not already present.
+The login shell is set to
+.Xr csh 1 .
+A new home directory at
+.Pa /home/gsmith
+is created if it does not already exist.
+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
 .Sh EXIT STATUS
 The
 .Nm