From owner-cvs-src@FreeBSD.ORG Mon Oct 2 20:30:27 2006 Return-Path: X-Original-To: cvs-src@FreeBSD.org Delivered-To: cvs-src@FreeBSD.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E129E16A4CA; Mon, 2 Oct 2006 20:30:27 +0000 (UTC) (envelope-from simon@zaphod.nitro.dk) Received: from mx.nitro.dk (zarniwoop.nitro.dk [83.92.207.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id 02F5D43D5D; Mon, 2 Oct 2006 20:30:24 +0000 (GMT) (envelope-from simon@zaphod.nitro.dk) Received: from zaphod.nitro.dk (unknown [192.168.3.39]) by mx.nitro.dk (Postfix) with ESMTP id 9761F2D4A96; Mon, 2 Oct 2006 20:30:23 +0000 (UTC) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id 8389611420; Mon, 2 Oct 2006 22:30:23 +0200 (CEST) Date: Mon, 2 Oct 2006 22:30:23 +0200 From: "Simon L. Nielsen" To: Jeremie Le Hen Message-ID: <20061002203022.GF1034@zaphod.nitro.dk> References: <200609131746.k8DHkKtX034248@repoman.freebsd.org> <20061002201251.GM96213@obiwan.tataz.chchile.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20061002201251.GM96213@obiwan.tataz.chchile.org> User-Agent: Mutt/1.5.11 Cc: cvs-src@FreeBSD.org, src-committers@FreeBSD.org, cvs-all@FreeBSD.org, Joel Dahl 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 X-BeenThere: cvs-src@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 02 Oct 2006 20:30:28 -0000 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