docs/162380: Documentation lacking for getfacl/setfacl

[Garrett Cooper]

>Number:         162380
>Category:       docs
>Synopsis:       Documentation lacking for getfacl/setfacl
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Nov 08 19:20:08 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Garrett Cooper
>Release:        9.0-RC1
>Organization:
n/a
>Environment:
FreeBSD bayonetta.local 9.0-RC1 FreeBSD 9.0-RC1 #0: Sat Nov  5 17:19:05 PDT 2011     root at bayonetta.local:/usr/obj/store/freebsd/stable/9/sys/BAYONETTA  amd64
>Description:
getfacl and setfacl are lacking documentation, s.t. it's hard to interpret ACL output from getfacl and it's hard to interpret what inputs need to be provided to setfacl in order to get the desired results in terms of permissions, etc.

Basically, it would be nice if acl(3) said what the print outs meant, and getfacl(1) and setfacl(1) referenced acl(3) so that everything could be tied together appropriately and people could better understand what the utilities do.
>How-To-Repeat:

>Fix:


>Release-Note:
>Audit-Trail:
>Unformatted: