acl man pages {and others?} (Was: symbolic link curiosity in 3.6.0)

[Brian Inglis]

On 2025-03-29 13:08, Alejandro Colomar wrote:
> On Sat, Mar 29, 2025 at 07:45:27PM +0100, Alejandro Colomar wrote:
>> Hi Bruno,
> 
> Oops, s/Bruno/Brian/  :)
> 
>>
>> On Sat, Mar 29, 2025 at 12:28:52PM -0600, Brian Inglis wrote:
>>> On 2025-03-29 05:43, Bruno Haible via Cygwin wrote:
>>>> Regarding what acl_extended_file() does, there is the man page by
>>>> Andreas Grünbacher:
>>>> https://www.kernel.org/doc/man-pages/online/pages/man3/acl_extended_file.3.html
>>>> Gnulib is not the only user of acl_extended_file(); therefore I would
>>>> suggest that Cygwin should follow that man page — regardless of Gnulib.
>>>
>>> Hi Alex,
>>>
>>> I noticed that the online man-pages include the acl docs (above) but the
>>> distributed man-pages do not!
>>
>> These pages are distributed as part of the act package.  On Debian,
>> the package that provides these manual pages is 'libacl1-dev'.
>>
>> 	alx@devuan:~$ apt-file find acl_extended_file.3
>> 	libacl1-dev: /usr/share/man/man3/acl_extended_file.3.gz
>>
>>> Would you please consider including the acl project man pages?
>>>
>>> 	https://git.savannah.nongnu.org/gitweb/?p=acl.git;a=tree;f=man
>>
>> I think it's better to keep them within the acl project, unless they
>> want us to take over.

I would consider packaging libacl unless it is Linux dependent if there is any 
Cygwin use case?

Otherwise, I would consider creating a new man-pages-extra package, including 
libacl, and any other package man pages where the package is not part of Cygwin, 
but the API is?

These man pages are available at man7.org as part of what Michael Kerrisk makes 
available online as part of Linux man pages:

	https://man7.org/linux/man-pages/dir_by_project.html

Has anyone a feel if there are any other projects on that list whose man pages 
would be useful under Cygwin even if the package itself is not available, or 
even individual man pages where they are not currently available?

-- 
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