From owner-svn-src-all@FreeBSD.ORG  Thu Nov 14 11:15:25 2013
Return-Path: <owner-svn-src-all@FreeBSD.ORG>
Delivered-To: svn-src-all@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id A9F58E35;
 Thu, 14 Nov 2013 11:15:25 +0000 (UTC)
Received: from cyrus.watson.org (cyrus.watson.org [198.74.231.69])
 by mx1.freebsd.org (Postfix) with ESMTP id 86D4A2129;
 Thu, 14 Nov 2013 11:15:25 +0000 (UTC)
Received: from c0188.aw.cl.cam.ac.uk (c0188.aw.cl.cam.ac.uk [128.232.100.188])
 by cyrus.watson.org (Postfix) with ESMTPSA id 423DB46B45;
 Thu, 14 Nov 2013 06:15:22 -0500 (EST)
Content-Type: text/plain; charset=iso-8859-2
Mime-Version: 1.0 (Mac OS X Mail 7.0 \(1822\))
Subject: Re: svn commit: r258041 - head/lib/libc/posix1e
From: "Robert N. M. Watson" <rwatson@FreeBSD.org>
In-Reply-To: <3C657070-0470-4107-81D8-73C6138F612C@FreeBSD.org>
Date: Thu, 14 Nov 2013 11:15:19 +0000
Content-Transfer-Encoding: quoted-printable
Message-Id: <8E1D58E8-7625-4D4A-AB77-D8C48EA3BB1E@FreeBSD.org>
References: <201311121044.rACAigGi093973@svn.freebsd.org>
 <alpine.BSF.2.00.1311140807000.10113@fledge.watson.org>
 <3C657070-0470-4107-81D8-73C6138F612C@FreeBSD.org>
To: =?iso-8859-2?Q?Edward_Tomasz_Napiera=B3a?= <trasz@FreeBSD.org>
X-Mailer: Apple Mail (2.1822)
Cc: svn-src-head@freebsd.org, svn-src-all@freebsd.org,
 src-committers@freebsd.org
X-BeenThere: svn-src-all@freebsd.org
X-Mailman-Version: 2.1.16
Precedence: list
List-Id: "SVN commit messages for the entire src tree \(except for &quot;
 user&quot; and &quot; projects&quot; \)" <svn-src-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-src-all>,
 <mailto:svn-src-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-all/>
List-Post: <mailto:svn-src-all@freebsd.org>
List-Help: <mailto:svn-src-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-all>,
 <mailto:svn-src-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 14 Nov 2013 11:15:25 -0000


On 14 Nov 2013, at 11:06, Edward Tomasz Napiera=B3a <trasz@FreeBSD.org> =
wrote:

> Wiadomo=B6=E6 napisana przez Robert Watson w dniu 14 lis 2013, o godz. =
09:07:
>> On Tue, 12 Nov 2013, Edward Tomasz Napierala wrote:
>>=20
>>> Mention acl_get_brand_np(3).
>>>=20
>>> MFC after:	2 weeks
>>> Sponsored by:	The FreeBSD Foundation
>>=20
>> Doing some writing recently, I did wonder if acl(3) and some of the =
other ACL API man pages might need a bit more updating to be clear about =
support for NFSv4 ACLs.  The user-facing man pages (getfacl(1), =
setfacl(1)) appear fully updated, but not much mention of NFSv4 in the =
programmer documentation.
>=20
> Hm, it should be already documented - from updated list of constants
> in acl_add_perm(3) or acl_set_tag_type(3), to new functions, such as
> acl_add_flag_np(3) or acl_set_entry_type_np(3).

Less a question of missing documentation than missing advertising. For =
example, acl(5) makes it really obvious that POSIX.1e semantics are =
supported, and the first mention of NFSv4 is in a long list of other =
unsupported types. We might want to begin simply by saying ".Fx supports =
POSIX.1e and NFSv4 ACLs" and expand a bit on the differences.

Robert=