DMARC-Filter: OpenDMARC Filter v1.4.2 delorie.com 5315RMZS2101912
Authentication-Results: delorie.com; dmarc=pass (p=none dis=none) header.from=cygwin.com
Authentication-Results: delorie.com; spf=pass smtp.mailfrom=cygwin.com
DKIM-Filter: OpenDKIM Filter v2.11.0 delorie.com 5315RMZS2101912
Authentication-Results: delorie.com;
	dkim=pass (1024-bit key, unprotected) header.d=cygwin.com header.i=@cygwin.com header.a=rsa-sha256 header.s=default header.b=XvqJo6xY
X-Recipient: archive-cygwin AT delorie DOT com
DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 13007384586D
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cygwin.com;
	s=default; t=1743485241;
	bh=huSE18LhRUePYVQoXtpV+1QjzdIvvYZdtYZaqy6ng2w=;
	h=Date:Subject:To:References:In-Reply-To:List-Id:List-Unsubscribe:
	 List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:
	 From;
	b=XvqJo6xYpBLD2YPFGlnH+WR8nUvjp1FScwXVvAvzmWt/U8z9l5fVtMT7xoG/kh/rR
	 0UH9IABNbwt5neaN0zxqLgKZUKTw0mw/xYR+DcSylRze0UPBFwQT22vAc+ysUqoTvY
	 UxlDHYFsIZkmluvALZJ+W7nNRew4RoGEB3gWH+Ts=
X-Original-To: cygwin AT cygwin DOT com
Delivered-To: cygwin AT cygwin DOT com
DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org D67413858D35
ARC-Filter: OpenARC Filter v1.0.0 sourceware.org D67413858D35
ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1743485205; cv=none;
 b=ru73HRG31WUz8pYAMicWY5kZnsdYPKvK31G3kyhXwWjWJxtkMNsOR9QusWPL+4H17Np9rPipgn5nnAtXMDSySveN6dDcqtDZWw8GE3XJyZnSPSVYBaBYOOAWsJEvpajfBCVOUPItnTc4lhJCmhWpRcVLGDOrQghKXZyJHqzz4NI=
ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key;
 t=1743485205; c=relaxed/simple;
 bh=c3HcA2yTpRtcrzH79Xx74Yn+Pia9xPRtGDBg6FrGoBE=;
 h=Message-ID:Date:MIME-Version:From:Subject:To:DKIM-Signature;
 b=BUzcgqzy+X+uaqaREwj/coUYPE+xS53xhyrlbkH6coJg82PJT7q8jAWtXaEz2r7u9gfhPV1Nfzr/BIguJ0tYNG6UDOM8o+R/tIXUanlupo1evInGM2bif5p6nL33Fuv24N7WEtw3KclXj0K6bhG2UYbtMLlT4Oer9klnHyKa8CQ=
ARC-Authentication-Results: i=1; server2.sourceware.org
DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org D67413858D35
Message-ID: <d0a1d86b-8708-4c44-9b81-dba8a5a667e7@systematicsw.ab.ca>
Date: Mon, 31 Mar 2025 23:26:27 -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 AT cygwin DOT com
References: <Pine DOT BSF DOT 4 DOT 63 DOT 2503250218240 DOT 74063 AT m0 DOT truegem DOT net>
 <11037686 DOT 3WhfQktd6Z AT nimes> <Z-fINO05FlFrTIUs AT calimero DOT vinschen DOT de>
 <7892953 DOT SKYDtnEIZr AT nimes>
 <20b30d5f-2e2d-4abb-a391-5956d98345b8 AT SystematicSW DOT ab DOT ca>
 <jkbpzugorztmkphew4jwoybfwywje5e5xn6dfpbfk2lso6u45o AT eezmf2m57vv2>
 <cwf5m5oemcbqxo2ppgfigglbnmp3dbu6tdkov66wsw45sijunf AT l4boe6wekhs7>
 <a0dce911-e661-45d4-aa6f-d1cc7fb1deba AT systematicsw DOT ab DOT ca>
 <Z-rjxlxWsCZ2T8HN AT calimero DOT vinschen DOT de>
Autocrypt: addr=brian DOT inglis AT systematicsw DOT ab DOT 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: <Z-rjxlxWsCZ2T8HN@calimero.vinschen.de>
X-Stat-Signature: pfc8y7qjntofqwk4b4zj31571dexsk9k
X-Rspamd-Server: rspamout06
X-Rspamd-Queue-Id: 0B3022000D
X-Session-Marker: 427269616E2E496E676C69734053797374656D6174696353572E61622E6361
X-Session-ID: U2FsdGVkX1/4d2aUgDyogFJzDRvSxhMGtet51xFTFqk=
X-HE-Tag: 1743485187-721542
X-HE-Meta: U2FsdGVkX1839gCzYG9k7SNpPeGX2zrnzett4ehLxsy78sL3JRhxSBMBTYnCXMxd85oEcq6Z/OV6l36h5kLLf6OPkcz9MTBqwTUu5dAWtfHi0fc89hevIpXJzpCtp0Gmoaon5H1uc6RYhicQGOQMSeVEPe2DxzNwyQQP/qz/0z7VSWFHFMh8zKt4BV5DwWCVGWnpkheLKq9D1P4DAd2Xw8JxUyE9LvcNFS+EGMZ7ZofqAooYQu6HrseblfRzIyZQ4EeQB0ZSIZT/6b+wxefRZBXNvCBArE5yCmb/E2dE4YOTHqlqI6I8aEGimUUf2Imj7ttopwhNKEj8pJ4KUYHUZWQWK7Mpg0vwy2A6YlmVA+za70nX4yRn7bGnSxIgsidf/3texYOMeriTo8HArgZDUYlxbvZ9q0aXpYMwfTi5QeKtxpBdPAihZbPwvHPQU+Pz8dqPAvqettc6bq4Trm/hu3pG7s+WCoKCL2vlmTjm+vDvsfXPJYF0JvUUXoXmJnadsrF57PPo+6gnD+81Vq3CTil1CS2klJF6lNPxFOuc15XiYC1wPICO+9PX9mkLI4p8I5fNiniFYig=
X-BeenThere: cygwin AT cygwin DOT com
X-Mailman-Version: 2.1.30
Precedence: list
List-Id: General Cygwin discussions and problem reports <cygwin.cygwin.com>
List-Unsubscribe: <https://cygwin.com/mailman/options/cygwin>,
 <mailto:cygwin-request AT cygwin DOT com?subject=unsubscribe>
List-Archive: <https://cygwin.com/pipermail/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-request AT cygwin DOT com?subject=help>
List-Subscribe: <https://cygwin.com/mailman/listinfo/cygwin>,
 <mailto:cygwin-request AT cygwin DOT com?subject=subscribe>
From: Brian Inglis via Cygwin <cygwin AT cygwin DOT com>
Reply-To: Brian DOT Inglis AT SystematicSW DOT ab DOT ca
Content-Type: text/plain; charset="utf-8"; Format="flowed"
Errors-To: cygwin-bounces~archive-cygwin=delorie DOT com AT cygwin DOT com
Sender: "Cygwin" <cygwin-bounces~archive-cygwin=delorie DOT com AT cygwin DOT com>
Content-Transfer-Encoding: 8bit
X-MIME-Autoconverted: from base64 to 8bit by delorie.com id 5315RMZS2101912

On 2025-03-31 12:49, Corinna Vinschen via Cygwin wrote:
> On Mar 31 12:35, Brian Inglis via Cygwin wrote:
>> 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 AT 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?
> 
> You can't do that.  Cygwin already provides most functions from libacl.
> Cygwin even provides the acl/libacl.h header.

Figures!

>> 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?
> 
> Sounds like a nice idea.
> 
>> 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?

> We have quite a few functions which might be only available on BSD systems,
> and we have these Solaris ACL functions which don't exist on Linux.  We
> probably can't use the man pages from Solaris due to copyright constraints,
> but the FreeBSD man pages should be ok.

The Solaris man pages were made available under the CDDL or PDL derived from 
MPL: we have Solaris 10 and OpenSolaris 2010 available on the freebsd.org site,
a well as most other OSes anyone might want: 520 of them, from 7th Edition, 
2.10BSD, 386BSD, thru 4.4Lite2, .

Space required for FreeBSD man pages is comparable to man-pages-linux - should 
we make all FreeBSD 15.0 current man pages available similar to man-pages-linux 
- man-pages-freebsd package and directory under /usr/share/man/ symlinked as 
freebsd for convenience with man -m|--systems SYSTEM,...?

Or should we stick to the original idea and package only selected missing man 
pages in the other sections of posix.xml as man-pages-extra?

> In terms of the POSIX.1e draft
> 17 ACL functions, the FreeBSD man pages (including acl.7) might be even
> better suited than the libacl man pages, with just minor deletions of
> non-existent functions.  And I'm going to add a few of the *_np functions
> only available on FreeBSD/NetBSD anyway...




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