>Number:         31125
>Category:       misc
>Synopsis:       pwhash(1) not referenced in important manpages
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Fri Sep 02 17:18:01 +0000 2005
>Originator:     Stefan Schumacher
>Release:        2.0.2 / 3.0_BETA
>Organization:
>Environment:
NetBSD wieland.net-tex.de 2.0.2 NetBSD 2.0.2 (WIELAND) #3: Sat Aug 27 19:15:03 CEST 2005  root@wieland.net-tex.de:/usr/home/202r/src/sys/arch/i386/compile/obj/WIELAND i386

>Description:
Several man pages about "password issues" like passwd(5), passwd.conf(5), pwd_mkdb(8), vipw(8), useradd(8), chpass(1), crypt(3) don't refer to pwhash(1). 

This is bad, since useradd(8) requires a password to be an already encrypted hash and it's hard to find pwhash(1).
>How-To-Repeat:
Read the specified man pages.
>Fix:
Add pwhash(1) to the "see also" section of regarding man pages 

and IMHO a short description of pwhash(1) should be added to the "-p" switch of man useradd, sth. like: 

"-p password   
 
specifies an already-encrypted password for the new user. Encrypted password hashes can be generated with pwhash(1). This password can then be changed by using the chpass(1) utility."