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: 25679
Status: resolved
Priority: 0/
Queue: Pod-Simple

People
Owner: hdp [...] cpan.org
Requestors: ANDK [...] cpan.org
Cc:
AdminCc:

Bug Information
Severity: Normal
Broken in:
  • 3.04
  • 3.05
Fixed in: (no value)



Subject: podlators 2 changed treatment of whitespace-only construction with S<>
pod2html and tkpod just to name a few treat a sequence matching /S<\s+>/ as whitespace. Podlators up to 2.0 did likewise. But since 2.0 pod2man and pod2text treat this as error AND lose the rest of the line. The following test script: =head1 The Tk::mega manpage showed me how C<< SE<lt> E<gt> foo >> is being rendered Both pod2text and pod2man S< > lose the rest of the line =head1 Do they always S< > lose the rest of the line? =cut use File::Spec; my $perl = File::Spec->rel2abs($^X); use File::Basename; my $pod2man = File::Basename::dirname($perl) . "/perldoc"; open my $fh, "-|", $perl, $pod2man, "-t", "-F", $0 or die; while (<$fh>) { print; } now prints: ----Output of .../pe53taG/perl-5.8.0@26295/bin/perl---- The Tk::mega manpage showed me how "S< > foo" is being rendered Both pod2text and pod2man Do they always POD ERRORS Hey! The above document had some coding errors, which are explained below: Around line 4: Unterminated S<...> sequence Around line 6: Unterminated S<...> sequence ----EOF ($?='0')---- Up to bleadperl 26291 it printed ----Output of .../pJmPzPp/perl-5.8.0@26291/bin/perl---- The Tk::mega manpage showed me how "S< > foo" is being rendered Both pod2text and pod2man lose the rest of the line Do they always lose the rest of the line? ----EOF ($?='0')----
Subject: Re: [rt.cpan.org #25679] podlators 2 changed treatment of whitespace-only construction with S<>
Date: Thu, 22 Mar 2007 16:29:14 -0700
To: bug-podlators [...] rt.cpan.org
From: Russ Allbery <rra [...] stanford.edu>
Andreas Koenig via RT <bug-podlators@rt.cpan.org> writes: Show quoted text
> pod2html and tkpod just to name a few treat a sequence matching
Show quoted text
> /S<\s+>/
Show quoted text
> as whitespace. Podlators up to 2.0 did likewise. But since 2.0 pod2man > and pod2text treat this as error AND lose the rest of the line.
S<> is handled internally by Pod::Simple; podlators never sees it. So this is a bug in Pod::Simple. Transferring it (if I can). -- Russ Allbery (rra@stanford.edu) <http://www.eyrie.org/~eagle/>
I don't believe this is broken in 3.05; I can't reproduce it with pod2text or pod2man (or with the example script). Can you reopen with more details if it's still happening to you?
CC: ANDK [...] cpan.org
Subject: Re: [rt.cpan.org #25679] podlators 2 changed treatment of whitespace-only construction with S<>
Date: Sun, 01 Jun 2008 06:20:59 +0200
To: bug-Pod-Simple [...] rt.cpan.org
From: andreas.koenig.7os6VVqR [...] franz.ak.mind.de (Andreas J. Koenig)
I can reproduce it with Pod::Simple 3.0[45] with appended test script. Fails for me with Pod::Text 3.0[678]. Pod::Text 2.21 doesn't use Pod::Simple and doesn't fail. -- andreas
=head1 The Tk::mega manpage showed me how C<< SE<lt> E<gt> foo >> is being rendered Both pod2text and pod2man S< > lose the rest of the line =head1 Do they always S< > lose the rest of the line? =cut use Pod::Text; use Test::More tests => 1; my $parser = Pod::Text->new(); my $out = $parser->parse_from_file($0,"$0.out"); open my $fh, "$0.out" or die; my $count_lose = 0; while (<$fh>) { if (/lose/){ $count_lose++; } } diag "Pod::Simple: v$Pod::Simple::VERSION"; diag "Pod::Text: v$Pod::Text::VERSION"; ok 2==$count_lose, "count_lose[$count_lose]";
Thanks. I'll try to fix this in time for 3.06.
I can't reproduce this with Pod::Simple::Text or Pod::Simple::XMLOutStream. I also can't figure out what it is about Pod::Text that triggers this bug. Any idea?
CC: ANDK [...] cpan.org
Subject: Re: [rt.cpan.org #25679] podlators 2 changed treatment of whitespace-only construction with S<>
Date: Mon, 02 Jun 2008 07:01:32 +0200
To: bug-Pod-Simple [...] rt.cpan.org
From: andreas.koenig.7os6VVqR [...] franz.ak.mind.de (Andreas J. Koenig)
Did you download the sample code or did you just copy and paste it? It seems to make a difference and I conclude the bug only appears when there is more than one space between the angle brackets. -- andreas
Show quoted text
> Did you download the sample code or did you just copy and paste it?
Yes. I figured out what the problem is; preserve_whitespace is on in Pod::Text but not in the other Pod::Simple subclasses I was using to test. I can reproduce it using Pod::Simple::Text now.
found it; this should be fixed in 3.06.