PR: docs/9045

    Update chpass(1) manual page.  Change the definition of the class
    field and also reorganize the field list to match that of the
    /etc/master.passwd file, to avoid confusion.

1 files changed, 31 insertions, 27 deletions

diff --git a/chpass/chpass.1 b/chpass/chpass.1
index c810f9b..a03c80a 100644
--- a/chpass/chpass.1
+++ b/chpass/chpass.1
@@ -30,7 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)chpass.1	8.2 (Berkeley) 12/30/93
-.\"     $Id: chpass.1,v 1.7.2.4 1998/08/14 03:38:01 thepish Exp $
+.\"     $Id: chpass.1,v 1.11 1998/08/14 03:47:38 thepish Exp $
 .\"
 .Dd December 30, 1993
 .Dt CHPASS 1
@@ -88,26 +88,30 @@ user's encrypted password
 user's login
 .It Gid:
 user's login group
+.It Class:
+user's general classification
 .It Change:
 password change time
 .It Expire:
 account expiration time
-.It Class:
-user's general classification
-.It Home Directory:
-user's home directory
-.It Shell:
-user's login shell
 .It Full Name:
 user's real name
 .It Location:
-user's normal location
+user's normal location (1)
 .It Home Phone:
-user's home phone
+user's home phone (1)
 .It Office Phone:
-user's office phone
+user's office phone (1)
 .It Other Information:
-any locally defined parameters for user
+any locally defined parameters for user (1)
+.It Home Directory:
+user's home directory
+.It Shell:
+user's login shell
+.Pp
+.It NOTE(1) -
+In the actual master.passwd file, these fields are comma-delimited
+fields embedded in the FullName field.
 .El
 .Pp
 The
@@ -141,6 +145,13 @@ This field may be filled in with either a number or a group name (see
 .Xr group 5 ) .
 .Pp
 The
+.Ar class
+field references class descriptions in
+.Ar /etc/login.conf
+and is typically used to initialize the user's system resource limits
+when they login.
+.Pp
+The
 .Ar change
 field is the date by which the password must be changed.
 .Pp
@@ -160,12 +171,15 @@ is the day of the month, and
 .Ar year
 is the year.
 .Pp
-The
-.Ar class
-field is currently unused.  In the near future it will be a key to
-a
-.Xr termcap 5
-style database of user attributes.
+Five fields are available for storing the user's
+.Ar full name , office location ,
+.Ar work
+and
+.Ar home telephone
+numbers and finally
+.Ar other information
+which is a single comma delimited string to represent any additional
+gcos fields (typically used for site specific user information).
 .Pp
 The user's
 .Ar home directory
@@ -186,16 +200,6 @@ shell.
 Non-standard is defined as a shell not found in
 .Pa /etc/shells .
 .Pp
-The last five fields are for storing the user's
-.Ar full name , office location ,
-.Ar work
-and
-.Ar home telephone
-numbers and finally
-.Ar other information
-which is a single comma delimited string to represent any additional
-gcos fields (typically used for site specific user information).
-.Pp
 Once the information has been verified,
 .Nm chpass
 uses