mdoc(7) police: overhaul.

Approved by:	re

1 files changed, 51 insertions, 41 deletions

diff --git a/adduser/rmuser.8 b/adduser/rmuser.8
index 85d6657..e27241a 100644
--- a/adduser/rmuser.8
+++ b/adduser/rmuser.8
@@ -31,7 +31,7 @@
 .Os
 .Sh NAME
 .Nm rmuser
-.Nd removes users from the system
+.Nd remove users from the system
 .Sh SYNOPSIS
 .Nm
 .Op Fl y
@@ -41,8 +41,8 @@
 The
 .Nm
 utility removes one or more users submitted on the command line
-or from a file. In removing a user from the system, this utility
-.Pp
+or from a file.
+In removing a user from the system, this utility:
 .Bl -enum
 .It
 Removes the user's
@@ -53,7 +53,9 @@ Removes any
 .Xr at 1
 jobs belonging to the user.
 .It
-Sends a SIGKILL signal to all processes owned by the user.
+Sends a
+.Dv SIGKILL
+signal to all processes owned by the user.
 .It
 Removes the user from the system's local password file.
 .It
@@ -61,13 +63,12 @@ Removes the user's home directory (if it is owned by the user),
 including handling of symbolic links in the path to the actual home
 directory.
 .It
-Removes the incoming mail and pop daemon mail files belonging to the
+Removes the incoming mail and POP daemon mail files belonging to the
 user from
 .Pa /var/mail .
 .It
 Removes all files owned by the user from
-.Pa /tmp ,
-.Pa /var/tmp ,
+.Pa /tmp , /var/tmp ,
 and
 .Pa /var/tmp/vi.recover .
 .It
@@ -76,66 +77,76 @@ Removes the username from all groups to which it belongs in
 (If a group becomes empty and the group name is the same as the username,
 the group is removed; this complements
 .Xr adduser 8 Ns 's
-per-user unique groups).
+per-user unique groups.)
 .El
 .Pp
-The 
+The
 .Nm
-utility refuses to remove users whose uid is 0 (typically root), since
+utility refuses to remove users whose UID is 0 (typically root), since
 certain actions (namely, killing all the user's processes, and perhaps
 removing the user's home directory) would cause damage to a running system.
-If it is necessary to remove a user whose uid is 0, see
+If it is necessary to remove a user whose UID is 0, see
 .Xr vipw 8
-for information on directly editing the password file
+for information on directly editing the password file.
 .Pp
 If
 .Nm
 was not invoked with the
 .Fl y
-switch it will
+option, it will
 show the selected user's password file entry and ask for confirmation
-that the user be removed.  It will then ask for confirmation to delete
-the user's home directory. If the answer is in the affirmative, the home
+that the user be removed.
+It will then ask for confirmation to delete
+the user's home directory.
+If the answer is in the affirmative, the home
 directory and any files and subdirectories under it will be deleted only if
-they are owned by the user. See
+they are owned by the user.
+See
 .Xr pw 8
 for more details.
 .Pp
 As
 .Nm
-operates, it informs the user regarding the current activity.  If any
+operates, it informs the user regarding the current activity.
+If any
 errors occur, they are posted to standard error and, if it is possible for
 .Nm
 to continue, it will.
 .Pp
-Available options:
-.Pp
-.Bl -tag -width username
-.It Fl y
-Implicitly answer "yes" to any and all prompts. Currently this includes
-prompts on whether to remove the specified user and whether to remove
-the home directory. This option requires that either the
-.Fl f
-option be used or one or more user names be given as commmand line
-arguments.
-.It Fl f
+The options are as follows:
+.Bl -tag -width ".Ar username"
+.It Fl f Ar file
 The
 .Nm
 utility will get a list of users to be removed from
 .Ar file ,
-which will contain one user per line. Anything following a hash mark (#),
+which will contain one user per line.
+Anything following a hash mark
+.Pq Ql # ,
 including the hash mark itself, is considered a comment and will not
-be processed. If the file is owned by anyone other than a user with
-uid 0 or is writeable by anyone other than the owner
+be processed.
+If the file is owned by anyone other than a user with
+UID 0, or is writeable by anyone other than the owner,
 .Nm
 will refuse to continue.
-.It Ar \&username
+.It Fl y
+Implicitly answer
+.Dq Li yes
+to any and all prompts.
+Currently, this includes
+prompts on whether to remove the specified user and whether to remove
+the home directory.
+This option requires that either the
+.Fl f
+option be used, or one or more user names be given as commmand line
+arguments.
+.It Ar username
 Identifies one or more users to be removed; if not present,
 .Nm
 interactively asks for one or more users to be removed.
 .El
 .Sh FILES
-.Bl -tag -width /etc/master.passwd -compact
+.Bl -tag -compact
 .It Pa /etc/master.passwd
 .It Pa /etc/passwd
 .It Pa /etc/group
@@ -157,10 +168,8 @@ interactively asks for one or more users to be removed.
 .Sh HISTORY
 The
 .Nm
-command appeared in
+utility appeared in
 .Fx 2.2 .
-.\" .Sh AUTHOR
-.\" Guy Helmer, Ames, Iowa
 .Sh BUGS
 The
 .Nm
@@ -171,19 +180,20 @@ It is also unable to remove symbolic links that were created by the
 user in
 .Pa /tmp
 or
-.Pa /var/tmp
+.Pa /var/tmp ,
 as symbolic links on
 .Bx 4.4
 filesystems do not contain information
-as to who created them.  Also, there may be other files created in
+as to who created them.
+Also, there may be other files created in
 .Pa /var/mail
 other than
-.Pa /var/mail/username
+.Pa /var/mail/ Ns Ar username
 and
-.Pa /var/mail/.pop.username
+.Pa /var/mail/.pop. Ns Ar username
 that are not owned by the removed user but should be removed.
 .Pp
 The
 .Nm
-utility has no knowledge of NIS (Yellow Pages), and it operates only on the
+utility has no knowledge of YP/NIS, and it operates only on the
 local password file.