[fbsd] cvs commit [HEAD] src/share/man/man7 hier.7 src/usr.bin/su su.1 src/usr.bin/login login.1 src/lib/libpam/modules/pam_login_access login.access.5

Simon L. Nielsen simon at FreeBSD.org
Mon Oct 2 13:30:28 PDT 2006


On 2006.10.02 22:12:51 +0200, Jeremie Le Hen wrote:
> Hi,
> 
> On Wed, Sep 13, 2006 at 05:46:20PM +0000, Joel Dahl wrote:
> > joel        2006-09-13 17:46:20 UTC
> > 
> >   FreeBSD src repository (doc committer)
> > 
> >   Modified files:
> >     share/man/man7       hier.7 
> >     usr.bin/su           su.1 
> >     usr.bin/login        login.1 
> >     lib/libpam/modules/pam_login_access login.access.5 
> >   Log:
> >   Remove references to the pam(8) manual page.  It does not exist.
> >   
> >   Requested by:   novel
> >   Discussed with: brueffer, simon
> 
> Why not import NetBSD's simple pam(8) manpage?  IMHO, this breaks
> POLA somehow: users may expect to do "man pam" and get a brief
> summary along with pointers to others manpages, instead of the
> PAM API.

I don't really see how this breaks POLA since the page hasn't been
there since FreeBSD 5.0.

It would be nice with pam(8) or some other generic PAM manual page,
but since this hasn't happened for quite a while it's better not to
references to a non-existing page.

As for NetBSD's pam(8) I can't really say if that is an option since I
haven't seen it.

> I saw a pretty good and complete article in share/doc/, but this
> must not replace the usual documentation.

There is an article in doc/, but AFAIR that is also largely
programming doc.

-- 
Simon L. Nielsen


More information about the cvs-src mailing list