unclear wording on getfacl manpage (--all != ALL)

[Corinna Vinschen]

On Feb 27 15:58, Linda Walsh wrote:
> on the CYGWIN getfacl manpage, it has
> 
>   -a, --all
>       display  the  filename, the owner, the group, and the ACL of the
>       file
> 
> --
> But in the linux version it says:
> 
> 
>    -a, --access
>        Display the file access control list.
> 
> --
> 
> The "--all" in the cygwin cygwin version sounds like it
> should display all ACL-related entries, but it really only
> displays the inode-specific acl on directories.
> 
> To display "all ACL-related entries", one uses no parameter.
> 
> The usage of "--all" to indicate the option "limits" output
> to only the "inode-specific" part is confusing and unclear.

The original getfacl was based on the Solaris getfacl (just as Cygwin's
ACL handling is based on the Solaris one).  It only had -a.  I guess the
--all was a thinko when adding the long options, as was --dir.

I changed that to --access and --default as on Linux.  I kept the --all
and --dir in for backward compatibility.  They are just undocumented now.


HTH,
Corinna

-- 
Corinna Vinschen                  Please, send mails regarding Cygwin to
Cygwin Maintainer                 cygwin AT cygwin DOT com
Red Hat
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 819 bytes
Desc: not available
URL: <http://cygwin.com/pipermail/cygwin/attachments/20150228/f9c14e44/attachment.sig>