Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 2 Oct 2006 22:30:23 +0200
From:      "Simon L. Nielsen" <simon@FreeBSD.org>
To:        Jeremie Le Hen <jeremie@le-hen.org>
Cc:        cvs-src@FreeBSD.org, src-committers@FreeBSD.org, cvs-all@FreeBSD.org, Joel Dahl <joel@FreeBSD.org>
Subject:   Re: [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
Message-ID:  <20061002203022.GF1034@zaphod.nitro.dk>
In-Reply-To: <20061002201251.GM96213@obiwan.tataz.chchile.org>
References:  <200609131746.k8DHkKtX034248@repoman.freebsd.org> <20061002201251.GM96213@obiwan.tataz.chchile.org>

next in thread | previous in thread | raw e-mail | index | archive | help
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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20061002203022.GF1034>