DMARC-Filter:	OpenDMARC Filter v1.4.2 delorie.com 53II1IUK3379829
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 53II1IUK3379829
X-Recipient:	archive-cygwin AT delorie DOT com
X-Original-To:	cygwin AT cygwin DOT com
Delivered-To:	cygwin AT cygwin DOT com
DMARC-Filter:	OpenDMARC Filter v1.4.2 sourceware.org 48DBD3858D1E
ARC-Filter:	OpenARC Filter v1.0.0 sourceware.org 48DBD3858D1E
ARC-Seal:	i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1744999251; cv=none;
	b=aiHdmfyKmL5MnMQc6gGZtd9MWQbQH+v79bhHJRCsqG44RgE4m8LdCTM3tCyvBlmLExsS5wm80pxiqIlxVJKsSJRVK8WfuBEqPGgs05Fc9+jUk7Zks0tCnUiFrcdJN5sph4DIsm4blHe4hgM3eNKG5Eu463da3DHP6E/+J65EiDk=
ARC-Message-Signature:	i=1; a=rsa-sha256; d=sourceware.org; s=key;
	t=1744999251; c=relaxed/simple;
	bh=+RL0NjpwgJTVazOZ/0Cc02NsURB+iksQ0nWertdcM48=;
	h=Message-ID:Date:MIME-Version:From:Subject:To:DKIM-Signature;
	b=FDuNF2R6TUe1ry1qnZzlBAPFMl+RgdYW0UqXQXZiCGTowEgz2qdf1e9mmDI9OFQxiOddlkDZCBjgIlOM9gFtNCFIelXPcD+JIA7KnHqzUabvFcrgVIqObGpUgNbRHlQs6cSpcSxSYa1K8+xsqGJPCL0zj2Aw8POfhLf8WLdQhBc=
ARC-Authentication-Results:	i=1; server2.sourceware.org
DKIM-Filter:	OpenDKIM Filter v2.11.0 sourceware.org 48DBD3858D1E
Message-ID:	<5586da8b-7007-4864-a04b-50657a77c105@SystematicSW.ab.ca>
Date:	Fri, 18 Apr 2025 12:00:47 -0600
MIME-Version:	1.0
User-Agent:	Mozilla Thunderbird
Subject:	Re: Missing .pod file for 'diagnostics' pragma in CygwinPerl package?
To:	cygwin AT cygwin DOT com
References:	<CAGB_HuQ6Zu3trH5nvq7LB7JaAsPpHg=gFnQNGKCzMb70Fw=pRw AT mail DOT gmail DOT com>
	<CAGB_HuRFXJuThQoQoTMxmoYkMTuBC4215=xTF=m=6E-_p3eHdQ AT mail DOT gmail DOT com>
Organization:	Systematic Software
In-Reply-To:	<CAGB_HuRFXJuThQoQoTMxmoYkMTuBC4215=xTF=m=6E-_p3eHdQ@mail.gmail.com>
X-Rspamd-Server:	rspamout03
X-Rspamd-Queue-Id:	216DC30
X-Stat-Signature:	xiu3z6od4mpcoep7bwia69rhtutiyqhr
X-Session-Marker:	427269616E2E496E676C69734053797374656D6174696353572E61622E6361
X-Session-ID:	U2FsdGVkX18hl76flFs8vPadVoE6K7QHLUmfb925wKk=
X-HE-Tag:	1744999248-741090
X-HE-Meta:	U2FsdGVkX18bLkWyl+BeQQbnRd54MXUOHl5nVsCx7we2h81rSHowECcu2dwCzmI6Vc+SDi8JtRO4pEZ7GUgcl3iVfCL0EPUXn75F+krzf6DlxPanRz40BdOtlEAc55rx92lCINaRKzMncpJwHf9LVIldZXkkDV22/cMnqdckvUsuN4JReNFnOht+kIFI/mkcEeL5GsQ3LvxywxisBJITYoWKmGYg6yrGSAfcr9yaTcPW6d4cvifz/LC7Wn0qMSf/xQhIr0qw4ap0y5/dDQHXMiidQ/wL0akeAwZSdksDecX4LbhYBsMCR0bepZnpUm6VheURjYgUsM+ZvTgOFcuHeeBeEdDGsSEc3j3AMBkcUVF6dvW7tEiFdDiC2+Qwh1KR7nhaL/btu+vG6KQbPI8RRA==
X-BeenThere:	cygwin AT cygwin DOT com
X-Mailman-Version:	2.1.30
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:	cygwin AT cygwin DOT com
Cc:	Brian Inglis <Brian DOT Inglis AT SystematicSW DOT ab DOT ca>
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>
X-MIME-Autoconverted:	from base64 to 8bit by delorie.com id 53II1IUK3379829

On 2025-04-17 19:34, Soren via Cygwin wrote:
> Hello Again, Cygwinistas;
> 
> On Thu, Apr 17, 2025 at 1:07 PM I wrote:
>>
>> Hello Cygwinstas,
>>
>> I've got a question about the cygwin perl package installed with cygwin setup. I'm having a failure in some perl code not written by me but rather in a CPAN module I am seeking to install. This failure does not occur on Gnu/Linux. The first 10 lines of that module are:
>>
>> package Array::Contains;
>>
>>
>> use 5.010_001;
>> use strict;
>> use warnings;
>> use diagnostics;
>> use mro 'c3';
>> use English;
>> our $VERSION = 2.8;
>> use Carp;
>>
>> Line 6 contains the directive to use the diagnostics pragma as you see. But when the perl compiler hits that line, it dies with the following long and slightly confusing messages:
>>
>> $ perl '-Mdiagnostics' -le 'print $diagnostics::VERSION'
>> couldn't find diagnostic data in /usr/share/perl5/5.40/pods/perldiag.pod /usr/share/perl5 /usr/local/lib/perl5/site_perl/5.40/x86_64-cygwin-threads /usr/local/share/perl5/site_perl/5.40 /usr/lib/perl5/vendor_perl/5.40/x86_64-cygwin-threads /usr/share/perl5/vendor_perl/5.40 /usr/lib/perl5/5.40/x86_64-cygwin-threads /usr/share/perl5/5.40 -e at /usr/share/perl5/5.40/diagnostics.pm line 259, <POD_DIAG> line 718.
>> Compilation failed in require.
>> BEGIN failed--compilation aborted.
> 
> I'm following up on my own message here. I've been discussing it with
> monks over at perlmonks (https://perlmonks.org) and someone there
> (monk named choroba) knew what was wrong; the file
> /usr/share/perl5/5.40/pods/perldiag.pod is, on Cygwin, not installed
> automatically with the base perl executable, library and core modules.
> It's in, rather, the optional package <<perl_pods>>.  So I installed
> that package and the problem went away.

One entry not yet in the FAQ is that Cygwin packages mainly split non-trivial 
docs, including those with lots of man pages, into separate -doc sub-packages.

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

- Raw text -