docs/103740: su(1) refers to pam(8) which doesn't exist

[Oliver Fromme]

>Number:         103740
>Category:       docs
>Synopsis:       su(1) refers to pam(8) which doesn't exist
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Sep 28 09:10:20 GMT 2006
>Closed-Date:
>Last-Modified:
>Originator:     Oliver Fromme
>Release:        FreeBSD 6.2-PRERELEASE
>Organization:
secnetix GmbH & Co. KG
		http://www.secnetix.de/bsd
>Environment:
System: FreeBSD epia.fromme.com 6.2-PRERELEASE FreeBSD 6.2-PRERELEASE #0: Wed Sep 20 14:47:28 CEST 2006 olli at epia.fromme.com:/usr/obj/usr/src/sys/EPIA i386

>Description:

	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.

>Fix:

--- src/usr.bin/su/su.1.orig    Tue Jan 31 21:32:36 2006
+++ src/usr.bin/su/su.1 Thu Sep 28 11:07:32 2006
@@ -231,9 +231,9 @@
 .Xr sh 1 ,
 .Xr group 5 ,
 .Xr login.conf 5 ,
+.Xr pam.conf 5 ,
 .Xr passwd 5 ,
 .Xr environ 7 ,
-.Xr pam 8 ,
 .Xr pam_group 8
 .Sh HISTORY
 A

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