Bug 103740

Summary: su(1) refers to pam(8) which doesn't exist
Product: Documentation Reporter: Oliver Fromme <olli>
Component: Books & ArticlesAssignee: Daniel Gerzo <danger>
Status: Closed FIXED    
Severity: Affects Only Me CC: olli
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description Oliver Fromme 2006-09-28 10:10:20 UTC 
	The su(1) manual page mentions pam(8) in the
	"see also" section, but such a manual page does
	not exist.

	I think it would make sense to refer to the
	pam.conf(5) manual page, which describes the
	format of /etc/pam.d/su, to which the text of
	the su(1) manual page refers.

	(There is, in fact, a pam(3) manual page, but
	it contains API programming information which
	isn't useful to someone who wants to configure
	PAM for the su(1) command.  Therefore I think
	that pam(3) shouldn't be mentioned in the su(1)
	manpage; it would rather cause confusion.)

How-To-Repeat: 
	Type "man 1 su", look at the "SEE ALSO" section,
	then try to type "man 8 pam".  Nada.
Comment 1 Daniel Gerzo freebsd_committer freebsd_triage 2006-09-28 15:28:02 UTC 
State Changed
From-To: open->patched

This is already fixed in HEAD, but needs to be MFC'ed.
Comment 2 Daniel Gerzo freebsd_committer freebsd_triage 2006-09-28 15:30:48 UTC 
Responsible Changed
From-To: freebsd-doc->danger

I will take care of this one.
Comment 3 Daniel Gerzo freebsd_committer freebsd_triage 2006-09-28 21:41:59 UTC 
State Changed
From-To: patched->closed

I have MFC'ed the change to RELENG_6 branch.
Note, that I don't think that referencing pam.conf(5) is necesarry here
since referenced pam_group(8) man page does this.