Re: cygwin-doc: please add acl description

On 2025-11-16 16:14, Aurélien Couderc wrote:
> On Sun, Nov 16, 2025 at 11:56 PM Brian Inglis via Cygwin-apps
> <[email protected]> wrote:
>>
>> On 2025-11-16 14:09, Thomas Wolff via Cygwin-apps wrote:
>>> Am 16.11.2025 um 21:57 schrieb Brian Inglis via Cygwin-apps:
>>>> On 2025-11-16 12:17, Brian Inglis via Cygwin-apps wrote:
>>>>> On 2025-11-16 02:46, Thomas Wolff via Cygwin-apps wrote:
>>>>>> Please add manual page acl(5) to package cygwin-doc:
>>>>>> acl(5): Access Control Lists - Linux man page <https://linux.die.net/man/5/acl>
>>>>>
>>>>> Discussed previously with Alex on man-pages(-linux), and as they are part of
>>>>> a package, considered them out of scope as they would be installed if the
>>>>> package was installed.
>>>>>
>>>>> Discussed with Corinna on patches and she considered the Linux ACL pages not fit
>>>>                                  ^W
>>>>                           cygwin/-apps Subject: ...acl man pages 2025-03-31+
>>>>
>>>> Listed all acl-related man pages from sources previously listed below.
>>>> ITP on apps but received no responses => no interest or demand!
>>>>
>>>>> for purpose on Cygwin, and suggested the BSD acl man-pages were a better fit.
>>>>> They are not available except as part of a *BSD man-pages package, some of
>>>>> which I install locally, but has not been requested by anyone else until now.
>>>>>
>>>>> Is there much interest out there for other distro man pages, or even Linux,
>>>>> which we currently package?
>>>>>
>>>>> I have previously downloaded and installed these for various interests:
>>>>>
>>>>> -rw-r--r-- 1 363K Nov 12  2022 /home/BWI/src/man/acl-2.3.2.tar.xz # Linux
>>>>> -rw-r--r-- 1  98M Dec  7  2017 /home/BWI/src/man/CentOS_7.1.tar.gz
>>>>> -rw-r--r-- 1 6.9M Dec  7  2017 /home/BWI/src/man/Darwin_7.0.1.tar.gz
>>>>> -rw-r--r-- 1 235M Dec  7  2017 /home/BWI/src/man/Debian_8.1.0.tar.gz
>>>>> -rw-r--r-- 1  12M Dec  7  2017 /home/BWI/src/man/FreeBSD_12.tar.gz
>>>>> -rw-r--r-- 1  15M Mar  9  2025 /home/BWI/src/man/FreeBSD_15.0.tgz # ACL...
>>>>> -rw-r--r-- 1 222M Dec  7  2017 /home/BWI/src/man/FreeBSD_Ports_11.1.tar.gz
>>>>> -rw-r--r-- 1  15M Dec  7  2017 /home/BWI/src/man/HP-UX_11.22.tar.gz
>>>>> -rw-r--r-- 1 1.6M Apr 30  2018 /home/BWI/src/man/Linux_4.16.tar.xz
>>>>> -rw-r--r-- 1  39M Dec  7  2017 /home/BWI/src/man/NetBSD_7.1.tar.gz
>>>>> -rw-r--r-- 1 9.6M Dec  7  2017 /home/BWI/src/man/OpenBSD_6.2.tar.gz
>>>>> -rw-r--r-- 1  13M Mar  2  2010 /home/BWI/src/man/OpenSolaris_2010.03.tgz
>>>>> -rw-r--r-- 1  37M Dec  7  2017 /home/BWI/src/man/Red_Hat_Linux_i386_9.tar.gz
>>>>> -rw-r--r-- 1  12M Dec  7  2017 /home/BWI/src/man/SunOS_5.10.tar.gz
>>>>> -rw-r--r-- 1  58M Dec  7  2017 /home/BWI/src/man/SuSE_Linux_i386_11.3.tar.gz
>>>>> -rw-r--r-- 1 4.4M Dec  7  2017 /home/BWI/src/man/X11_R7.4.tar.gz
>>>>>
>>>>> Linux is up to date:
>>>>>
>>>>> -rw-r--r-- 1  12M Nov 13 07:02 man-pages-linux-6.16-1-noarch.tar.xz
>>>>>
>>>>> Everyone is waiting to see if Austin group will release POSIX 2025!
>>>>>
>>>>> -rw-r--r-- 1 2.6M Apr 12  2021 man-pages-posix-2017a-1.tar.xz
>>
>>> Well, the point is: get/setfacl man pages are part of cygwin-doc but the
>>> description of how acls work and particularly of how default acls work in these
>>> is lousy at best;
>>> acl(5) has a much better description but is not part of any cygwin package right
>>> now.
>>
>> Please have a look at previous posts about relevant distro man pages suggested
>> by Corinna in Cygwin, acl related contents listed by me on Cygwin-Apps, suggest
>> which man pages may best meet your needs, then others may chime in, or you may
>> download and install them yourself - I use /proc/cygdrive/c/usr/local/share/man/
>> FYI.
> 
> Cygwin also supports Solaris-style ZFS ACLs, are they being covered by
> those manpages too?

They may be in the SunOS or OpenSolaris acl pages.

Please review the "acl man pages" posts around 2025-04-01 for the man pages 
sources and lists of available acl-related man pages, and let us know which you 
think might be most suitable, given that we will provide packages of all man 
pages from any given distro we choose.

Most distros man pages may be browsed from the FreeBSD site:

	https://man.freebsd.org/cgi/man.cgi

-- 
Take care. Thanks, Brian Inglis              Calgary, Alberta, Canada

La perfection est atteinte                   Perfection is achieved
non pas lorsqu'il n'y a plus rien à ajouter  not when there is no more to add
mais lorsqu'il n'y a plus rien à retrancher  but when there is no more to cut
                                 -- Antoine de Saint-Exupéry