pod-people & perlbug:
I made the subject posting on the Cygwin mailing list. Gerrit P. Haase
confirmed the bug in pod2usage(), and requested that I forward the posting to
pod-people and perlbug. The referenced script attachments follow.
HTH,
David
-----Original Message-----
From: David Christensen [mailto: dpchrist at holgerdanske dot com]
Sent: Sunday, January 16, 2005 7:03 PM
To: 'cygwin at cygwin dot com'
Subject: Cygwin Perl bug -- pod2usage(-verbose => 0) & pod2usage(-verbose => 1)
Cygwin:
Perl Pod::Usage pod2usage(-verbose => 0) is supposed to display the Pod SYNOPSIS
information (ref. 'perdoc Pod::Usage'). See attached script 'test0'. On Debian
3.0r2, it works:
<CVSENV>[EMAIL PROTECTED]:~/cygwin-issues/Pod-Usage$ perl test0
Usage:
This is the synopsis...
On Cygwin, it exits without displaying anything.
pod2usage(-verbose => 1) is supposed to display the Pod SYNOPSIS, OPTIONS,
ARGUMENTS, and/or OPTIONS AND ARGUMENTS sections. See attached script 'test1'.
On Debian, it works:
<CVSENV>[EMAIL PROTECTED]:~/cygwin-issues/Pod-Usage$ perl test1
Usage:
This is the synopsis...
Options:
Here are the options...
On Cygwin, it exits without displaying anything.
pod2usage(-verbose => 2) is supposed to display the entire Pod documentation.
See attached script 'test2'. It works on both Debian and Cygwin.
Checking the mailing list archive, I see one report but no resolution:
http://sources.redhat.com/ml/cygwin/2002-01/msg01392.html
Google didn't seem to have much on this either.
David
[EMAIL PROTECTED]:~/mydocuments/cygwin-issues/Pod-Usage$ cat test0
#! /usr/bin/perl -w
use Pod::Usage;
pod2usage(-verbose => 0);
=pod
=head1 NAME
test - demonstrates Cygwin bug in pod2usage.
=head1 SYNOPSIS
This is the synopsis...
=head1 OPTIONS
Here are the options...
=head1 DESCRIPTION
Descriptive text...
=cut
[EMAIL PROTECTED]:~/mydocuments/cygwin-issues/Pod-Usage$ cat test1
#! /usr/bin/perl -w
use Pod::Usage;
pod2usage(-verbose => 1);
=pod
=head1 NAME
test - demonstrates Cygwin bug in pod2usage.
=head1 SYNOPSIS
This is the synopsis...
=head1 OPTIONS
Here are the options...
=head1 DESCRIPTION
Descriptive text...
=cut
[EMAIL PROTECTED]:~/mydocuments/cygwin-issues/Pod-Usage$ cat test2
#! /usr/bin/perl -w
use Pod::Usage;
pod2usage(-verbose => 2);
=pod
=head1 NAME
test - demonstrates Cygwin bug in pod2usage.
=head1 SYNOPSIS
This is the synopsis...
=head1 OPTIONS
Here are the options...
=head1 DESCRIPTION
Descriptive text...
=cut
