cygwin-doc: please add acl description

[Aurélien Couderc]

On Sun, Nov 16, 2025 at 11:56 PM Brian Inglis via Cygwin-apps
<cygwin-apps@cygwin.com> 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?

Aurélien
-- 
Aurélien Couderc <aurelien.couderc2002@gmail.com>
Big Data/Data mining expert, chess enthusiast