docs/74656: [PATCH] some improvements to man 5 passwd

[Jilles Tjoelker]

>Number:         74656
>Category:       docs
>Synopsis:       [PATCH] some improvements to man 5 passwd
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Fri Dec 03 17:40:25 GMT 2004
>Closed-Date:
>Last-Modified:
>Originator:     Jilles Tjoelker
>Release:        FreeBSD 5.3-RELEASE i386
>Organization:
MCGV Stack
>Environment:
System: FreeBSD snail.stack.nl 5.3-RELEASE FreeBSD 5.3-RELEASE #3: Wed Nov 17 19:36:18 CET 2004 jilles at snail.stack.nl:/usr/obj/usr/src/sys/SNAIL i386
>Description:
- Note explicitly (again) that master.passwd and passwd should not be edited
  manually
- Add reference to crypt(3) to description of "encrypted password"
- Add reference to pw(8) -- this method to change passwd and group did not
  exist in 4.4BSD
- Remove "Class is currently not implemented" in COMPATIBILITY section
>How-To-Repeat:
man 5 passwd
>Fix:
patch included

--- passwd.5.patch begins here ---
--- src/share/man/man5/passwd.5.orig	Thu Nov 11 21:28:50 2004
+++ src/share/man/man5/passwd.5	Fri Dec  3 18:27:36 2004
@@ -61,6 +61,9 @@
 as controlled by
 .Xr nsswitch.conf 5 .
 .Pp
+To ensure consistency among the files, none of them should not be edited
+manually.
+.Pp
 The
 .Nm master.passwd
 file is readable only by root, and consists of newline separated
@@ -126,7 +129,8 @@
 .Pp
 The password field is the
 .Em encrypted
-form of the password.
+form of the password (see
+.Xr crypt 3 ) .
 If the
 .Ar password
 field is empty, no password will be required to gain access to the
@@ -321,6 +325,7 @@
 .Xr login.conf 5 ,
 .Xr netgroup 5 ,
 .Xr adduser 8 ,
+.Xr pw 8 ,
 .Xr pwd_mkdb 8 ,
 .Xr vipw 8 ,
 .Xr yp 8
@@ -345,9 +350,8 @@
 and
 .Dq expire
 are added, but are turned off by default.
-Class is currently not implemented, but change and expire are; to set them,
-use the current day in seconds from the epoch + whatever number of seconds
-of offset you want.
+To set them, use the current day in seconds from the epoch + whatever number
+of seconds of offset you want.
 .Bd -literal -offset indent
 BEGIN { FS = ":"}
 { print $1 ":" $2 ":" $3 ":" $4 "::0:0:" $5 ":" $6 ":" $7 }
--- passwd.5.patch ends here ---


>Release-Note:
>Audit-Trail:
>Unformatted: