Skip Menu |

Preferred bug tracker

Please visit the preferred bug tracker to report your issue.

This queue is for tickets about the Pod-Simple CPAN distribution.

Report information
The Basics
Id: 64704
Status: rejected
Priority: 0/
Queue: Pod-Simple
People
Owner: Nobody in particular
Requestors: vkavalov [...] apple.com
Cc:
AdminCc:
Bug Information
Severity: (no value)
Broken in: (no value)
Fixed in: (no value)
Attachments
perldoc_test_D.log
pod2man_test_D.log
test_D

History Show all quoted text
  Tue Jan 11 18:46:50 2011 vkavalov [...] apple.com - Ticket created
CC: vesselin kavalov <vkavalov [...] apple.com>
Subject: Pod::Simple clobbers my command-line switch definition
Date: Tue, 11 Jan 2011 15:46:35 -0800
To: bug-pod-simple [...] rt.cpan.org
From: vesselin kavalov <vkavalov [...] apple.com>
Hi, if you run 'perldoc ' you should see: ----------------------------------------------------------------------------------------------------------------------------- TEST_D(1) User Contributed Perl Documentation TEST_D(1) OPTIONS -D<macro> Configuration MACROS perl v5.10.1 2011-01-11 TEST_D(1) ----------------------------------------------------------------------------------------------------------------------------- instead, you see (see ) I am attaching as well. I was tracing the problem around and found that 'D' switch gets clobbered in: Pod::Simple.pm ($VERSION = '3.07'): line 694 $is = $treelet->[$i][0] = $map->{ $was = $treelet->[$i][0] }; Don't quite understand why only these: 23 @Known_formatting_codes = qw(I B C L E F S X Z); single CAP letters are preserved ?!?! if the switch name is '-d' for example - there is no problem. If I use '-E' (from the "insider's list" above ;) it shows the info OK, but still reports Error ?! Anyway, it is NOT my choice of using '-D' with no space to the value - it's been a convention in the EDA industry forever - so I am stuck with it. I would LOVE if U fix this one, since I want to use Getopt::Euclid for my command-line parsing, but it relies on Pod::Simple. BTW, I found a minor DEBUG reporting bug in Pod::Simple::BlackBox.pm ( ): 1735 } elsif(defined $5) { 1736 DEBUG > 3 and print "Found apparent simple end-text code \"$4\"\n"; ^ this should be $5 I think. Thanx! vess
Hi,

if you run 'perldoc 
Download test_D
application/octet-stream 102b

Message body not shown because it is not plain text.

'  you should see:
-----------------------------------------------------------------------------------------------------------------------------
TEST_D(1)                            User Contributed Perl Documentation                            TEST_D(1)



OPTIONS
       -D<macro>
           Configuration MACROS



perl v5.10.1                                      2011-01-11                                        TEST_D(1)
-----------------------------------------------------------------------------------------------------------------------------

instead, you see (see 
Download perldoc_test_D.log
application/octet-stream 381b

Message body not shown because it is not plain text.

)

I am attaching 
Download pod2man_test_D.log
application/octet-stream 4k

Message body not shown because it is not plain text.

 as well.

I was tracing the problem around and found that 'D' switch gets clobbered in:

Pod::Simple.pm ($VERSION = '3.07'):

line 694       $is = $treelet->[$i][0] = $map->{ $was = $treelet->[$i][0] };

Don't quite understand why only these:

23 @Known_formatting_codes = qw(I B C L E F S X Z);

single CAP letters are preserved ?!?!

if the switch name is '-d' for example - there is no problem. If I use '-E' (from the "insider's list" above ;)
it shows the info OK, but still reports Error ?!


Anyway, it is NOT my choice of using '-D' with no space to the value - it's been a convention in the EDA industry forever - so I am stuck with it.
I would LOVE if U fix this one, since I want to use Getopt::Euclid for my command-line parsing, but it relies on Pod::Simple.

BTW, I found a minor DEBUG reporting bug in Pod::Simple::BlackBox.pm ( ):

1735     } elsif(defined $5) {
1736       DEBUG > 3 and print "Found apparent simple end-text code \"$4\"\n";
                                                                                                                                 ^
                                                                                          this should be $5 I think.

Thanx!
vess


  Mon Feb 28 18:15:38 2011 dwheeler [...] cpan.org - Correspondence added
On Tue Jan 11 18:46:50 2011, vkavalov@apple.com wrote: Show quoted text
> Don't quite understand why only these: > > 23 @Known_formatting_codes = qw(I B C L E F S X Z); > > single CAP letters are preserved ?!?!
Yes, they are. You should always escape < and >. So what you want is: =item -DE<lt>macroE<gt> With that, I get this for the output: OPTIONS −D<macro> Configuration MACROS Show quoted text
> 1735 } elsif(defined $5) { > 1736 DEBUG > 3 and print "Found apparent simple end-text code > \"$4\"\n"; > ^ > this > should be $5 I think.
That was fixed in October, 2009: https://github.com/theory/pod- simple/commit/e1fe004833fdf6d9b87aa1ea08e651b5dd8b6cd7 What version of Pod::Simple are you using? You might want to upgrade.
  Mon Feb 28 18:15:40 2011 The RT System itself - Status changed from 'new' to 'open'
  Mon Feb 28 18:15:40 2011 dwheeler [...] cpan.org - Status changed from 'open' to 'rejected'
  Mon Feb 28 19:44:12 2011 vkavalov [...] apple.com - Correspondence added
CC: vesselin kavalov <vkavalov [...] apple.com>
Subject: Re: [rt.cpan.org #64704] Pod::Simple clobbers my command-line switch definition
Date: Mon, 28 Feb 2011 16:44:03 -0800
To: bug-Pod-Simple [...] rt.cpan.org
From: vesselin kavalov <vkavalov [...] apple.com>
Thanx David! This was my first "serious" bout with Pod::Simple. I should have RTFM carefully before screaming "BUG" :( This was gating my use of Getopt::Euclid but I'll re-visit it again. As you can see I work at a big corporation with its own policies about versioning of SW - it's not my choice :( Thanx again! vess On Feb 28, 2011, at 3:15 PM, David Wheeler via RT wrote: Show quoted text
> <URL: https://rt.cpan.org/Ticket/Display.html?id=64704 > > > On Tue Jan 11 18:46:50 2011, vkavalov@apple.com wrote: >
>> Don't quite understand why only these: >> >> 23 @Known_formatting_codes = qw(I B C L E F S X Z); >> >> single CAP letters are preserved ?!?!
> > Yes, they are. You should always escape < and >. So what you want is: > > =item -DE<lt>macroE<gt> > > With that, I get this for the output: > > OPTIONS > −D<macro> > Configuration MACROS >
>> 1735 } elsif(defined $5) { >> 1736 DEBUG > 3 and print "Found apparent simple end-text code >> \"$4\"\n"; >> ^ >> this >> should be $5 I think.
> > That was fixed in October, 2009: > > https://github.com/theory/pod- > simple/commit/e1fe004833fdf6d9b87aa1ea08e651b5dd8b6cd7 > > What version of Pod::Simple are you using? You might want to upgrade.
  Mon Feb 28 19:44:12 2011 The RT System itself - Status changed from 'rejected' to 'open'
  Mon Mar 14 13:33:22 2011 dwheeler [...] cpan.org - Correspondence added
On Mon Feb 28 19:44:12 2011, vkavalov@apple.com wrote: Show quoted text
> Thanx David! This was my first "serious" bout with Pod::Simple. I > should have RTFM carefully before screaming "BUG" :( > This was gating my use of Getopt::Euclid but I'll re-visit it again. > > As you can see I work at a big corporation with its own policies about > versioning of SW - it's not my choice :(
No worries. You might want to have a look at local::lib. It allows you to install CPAN modules in your home directory on a server where you have limited permissions. You can then use them pretty much like system-wide modules. That's assuming, of course, that you don't have other deployment requirements to get in the way. Big corporation: Yeah, true, but yours is far more agile than most. Or so at least it appears from the outside. :-) Best, David
  Mon Mar 14 13:33:23 2011 dwheeler [...] cpan.org - Status changed from 'open' to 'rejected'