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?
Content-Language: en-CA
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
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: cygwin AT cygwin DOT com
Cc: Brian Inglis <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 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