DMARC-Filter: OpenDMARC Filter v1.4.2 delorie.com 52VIaBgU1871690
DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 8D292385AC3D
Message-ID: <a0dce911-e661-45d4-aa6f-d1cc7fb1deba@systematicsw.ab.ca>
Date: Mon, 31 Mar 2025 12:35:08 -0600
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: Re: acl man pages {and others?} (Was: symbolic link curiosity in
 3.6.0)
Content-Language: en-CA
To: cygwin@cygwin.com
References: <Pine.BSF.4.63.2503250218240.74063@m0.truegem.net>
 <11037686.3WhfQktd6Z@nimes> <Z-fINO05FlFrTIUs@calimero.vinschen.de>
 <7892953.SKYDtnEIZr@nimes>
 <20b30d5f-2e2d-4abb-a391-5956d98345b8@SystematicSW.ab.ca>
 <jkbpzugorztmkphew4jwoybfwywje5e5xn6dfpbfk2lso6u45o@eezmf2m57vv2>
 <cwf5m5oemcbqxo2ppgfigglbnmp3dbu6tdkov66wsw45sijunf@l4boe6wekhs7>
Autocrypt: addr=Brian.Inglis@systematicsw.ab.ca; keydata=
 xjMEXopx8xYJKwYBBAHaRw8BAQdAnCK0qv/xwUCCZQoA9BHRYpstERrspfT0NkUWQVuoePbN
 LkJyaWFuIEluZ2xpcyA8QnJpYW4uSW5nbGlzQFN5c3RlbWF0aWNTdy5hYi5jYT7ClgQTFggA
 PhYhBMM5/lbU970GBS2bZB62lxu92I8YBQJeinHzAhsDBQkJZgGABQsJCAcCBhUKCQgLAgQW
 AgMBAh4BAheAAAoJEB62lxu92I8Y0ioBAI8xrggNxziAVmr+Xm6nnyjoujMqWcq3oEhlYGAO
 WacZAQDFtdDx2koSVSoOmfaOyRTbIWSf9/Cjai29060fsmdsDM44BF6KcfMSCisGAQQBl1UB
 BQEBB0Awv8kHI2PaEgViDqzbnoe8B9KMHoBZLS92HdC7ZPh8HQMBCAfCfgQYFggAJhYhBMM5
 /lbU970GBS2bZB62lxu92I8YBQJeinHzAhsMBQkJZgGAAAoJEB62lxu92I8YZwUBAJw/74rF
 IyaSsGI7ewCdCy88Lce/kdwX7zGwid+f8NZ3AQC/ezTFFi5obXnyMxZJN464nPXiggtT9gN5
 RSyTY8X+AQ==
Organization: Systematic Software
In-Reply-To: <cwf5m5oemcbqxo2ppgfigglbnmp3dbu6tdkov66wsw45sijunf@l4boe6wekhs7>
Precedence: list
From: Brian Inglis via Cygwin <cygwin@cygwin.com>
Reply-To: cygwin@cygwin.com
Cc: Brian Inglis <Brian.Inglis@systematicsw.ab.ca>
Content-Type: text/plain; charset="utf-8"; Format="flowed"
Errors-To: cygwin-bounces~archive-cygwin=delorie.com@cygwin.com
Sender: "Cygwin" <cygwin-bounces~archive-cygwin=delorie.com@cygwin.com>
Content-Transfer-Encoding: 8bit

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

-- 
Problem reports:      https://cygwin.com/problems.html
FAQ:                  https://cygwin.com/faq/
Documentation:        https://cygwin.com/docs.html
Unsubscribe info:     https://cygwin.com/ml/#unsubscribe-simple