From jilles@stack.nl  Fri Dec  3 17:34:01 2004
Return-Path: <jilles@stack.nl>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id EE06416A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Fri,  3 Dec 2004 17:34:01 +0000 (GMT)
Received: from mailhost.stack.nl (vaak.stack.nl [131.155.140.140])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 3042D43D41
	for <FreeBSD-gnats-submit@freebsd.org>; Fri,  3 Dec 2004 17:34:01 +0000 (GMT)
	(envelope-from jilles@stack.nl)
Received: from snail.stack.nl (snail.stack.nl [IPv6:2001:610:1108:5010::131])
	by mailhost.stack.nl (Postfix) with ESMTP id 222851F026
	for <FreeBSD-gnats-submit@freebsd.org>; Fri,  3 Dec 2004 18:34:00 +0100 (CET)
Received: by snail.stack.nl (Postfix, from userid 1677)
	id 00EB822822; Fri,  3 Dec 2004 18:33:59 +0100 (CET)
Message-Id: <20041203173359.00EB822822@snail.stack.nl>
Date: Fri,  3 Dec 2004 18:33:59 +0100 (CET)
From: Jilles Tjoelker <jilles@stack.nl>
Reply-To: Jilles Tjoelker <jilles@stack.nl>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] some improvements to man 5 passwd
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         74656
>Category:       docs
>Synopsis:       [PATCH] some improvements to man 5 passwd
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Fri Dec 03 17:40:25 GMT 2004
>Closed-Date:    Tue Feb 08 20:10:30 GMT 2005
>Last-Modified:  Tue Feb 08 20:10:30 GMT 2005
>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@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:
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Tue Feb 8 20:09:32 GMT 2005 
State-Changed-Why:  
Slightly different version of your patch applied to avoid 
the double negative.  Thanks for the submission! 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Tue Feb 8 20:09:32 GMT 2005 
Responsible-Changed-Why:  
Over to me. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=74656 
>Unformatted:
