On 14 Nov 2013, at 11:06, Edward Tomasz Napierała <tr...@freebsd.org> wrote:

> Wiadomość napisana przez Robert Watson w dniu 14 lis 2013, o godz. 09:07:
>> On Tue, 12 Nov 2013, Edward Tomasz Napierala wrote:
>> 
>>> Mention acl_get_brand_np(3).
>>> 
>>> MFC after:  2 weeks
>>> Sponsored by:       The FreeBSD Foundation
>> 
>> 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.
> 
> 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
_______________________________________________
svn-src-head@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-head
To unsubscribe, send any mail to "svn-src-head-unsubscr...@freebsd.org"

Reply via email to