adduser example in the Handbook.
MFC after: 1 week
.\"
.\" $FreeBSD$
.\"
-.Dd March 27, 2016
+.Dd April 23, 2016
.Dt PW 8
.Os
.Sh NAME
.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