Assorted simple improvements:

- Considerably simplify the first paragraph; suggested by Raf Czlonka.
- No need to say twice that "file" must be in the correct format.
- Clarify which file is checked by -c.
- Clarify that -p creates passwd(5) in addition, not instead.
- Simplify reference to the master.passwd(5) format.
- Turn one sentence into a standard EXIT STATUS section.
- New HISTORY and AUTHORS sections, based on the CSRG archive CDs.

1 files changed, 23 insertions, 22 deletions

diff --git a/usr.sbin/pwd_mkdb/pwd_mkdb.8 b/usr.sbin/pwd_mkdb/pwd_mkdb.8
index 614b92e250b..05471317993 100644
--- a/usr.sbin/pwd_mkdb/pwd_mkdb.8
+++ b/usr.sbin/pwd_mkdb/pwd_mkdb.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: pwd_mkdb.8,v 1.27 2016/08/16 17:51:38 tedu Exp $
+.\"	$OpenBSD: pwd_mkdb.8,v 1.28 2017/09/10 16:24:43 schwarze Exp $
 .\"
 .\" Copyright (c) 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"	from: @(#)pwd_mkdb.8	8.1 (Berkeley) 6/6/93
 .\"
-.Dd $Mdocdate: August 16 2016 $
+.Dd $Mdocdate: September 10 2017 $
 .Dt PWD_MKDB 8
 .Os
 .Sh NAME
@@ -44,27 +44,23 @@
 .Ar file
 .Sh DESCRIPTION
 .Nm
-creates a pair of Berkeley databases for the specified file.
-These databases are then installed into
+creates a pair of Berkeley databases from
+.Ar file
+and installs them into
 .Pa /etc/spwd.db
 and
-.Pa /etc/pwd.db ,
-respectively.
+.Pa /etc/pwd.db .
 The
 .Ar file
-argument is installed into
-.Pa /etc/master.passwd
-by renaming
-.Ar file .
-The
-.Ar file
-must be in the correct format (see
-.Xr passwd 5 ) .
+argument is renamed to
+.Pa /etc/master.passwd .
 .Pp
 The options are as follows:
 .Bl -tag -width Ds
 .It Fl c
-Check if the password file is in the correct format.
+Check whether
+.Ar file
+is in the correct format.
 Do not change, add, or remove any files.
 .It Fl d Ar directory
 Operate in a base directory other than the default of
@@ -83,7 +79,7 @@ for instance in a
 .Xr chroot 8
 jail.
 .It Fl p
-Create a legacy password file and install it into
+Also create a legacy password file and install it into
 .Pa /etc/passwd .
 .It Fl s
 Only update the secure version of the database.
@@ -104,9 +100,8 @@ This option must never be used if the line number of the user's record in
 has changed.
 .It Ar file
 The absolute path to a file in
-.Ar master.passwd
-format, as described in
-.Xr passwd 5 .
+.Xr master.passwd 5
+format.
 .El
 .Pp
 The two databases differ in that the secure version contains the user's
@@ -115,9 +110,6 @@ encrypted password and the insecure version has an asterisk
 .Pp
 The databases are used by the C library password routines (see
 .Xr getpwent 3 ) .
-.Pp
-.Nm
-exits zero on success, non-zero on failure.
 .Sh FILES
 .Bl -tag -width /etc/master.passwd -compact
 .It Pa /etc/master.passwd
@@ -133,6 +125,8 @@ secure password database file
 .It Pa /etc/spwd.db.tmp
 temporary file
 .El
+.Sh EXIT STATUS
+.Ex -std
 .Sh SEE ALSO
 .Xr chpass 1 ,
 .Xr passwd 1 ,
@@ -140,6 +134,13 @@ temporary file
 .Xr getpwent 3 ,
 .Xr passwd 5 ,
 .Xr vipw 8
+.Sh HISTORY
+The
+.Nm
+utility first appeared in
+.Bx 4.3 Net/2 .
+.Sh AUTHORS
+.An Keith Bostic
 .Sh BUGS
 Because of the necessity for atomic update of the password files,
 .Nm