Beefy Boxes and Bandwidth Generously Provided by pair Networks
laziness, impatience, and hubris

Re: pod-error in perldocs

by ikegami (Pope)
on Sep 23, 2009 at 15:55 UTC ( #797005=note: print w/replies, xml ) Need Help??

in reply to pod-error in perldocs

y/// is the last item in perlfunc, so the item is ended by =back.

Whatever is splitting the entries in perlfunc is probably using /^=item\b/m to find where the item ends. This needs to be /^=(?:item|back)\b/m.

Replies are listed 'Best First'.
Re^2: pod-error in perldocs
by thunders (Priest) on Sep 23, 2009 at 16:04 UTC
    That is correct. This is the relevant section in Pod/ search_perlfunc()
    891 while (<PFUNC>) { # "The Mothership Connection is here!" 892 if ( m/^=item\s+$search_re\b/ ) { 893 $found = 1; 894 } 895 elsif (/^=item/) { 896 last if $found > 1 and not $inlist; 897 } 898 next unless $found; 899 if (/^=over/) { 900 ++$inlist; 901 } 902 elsif (/^=back/) { 903 --$inlist; 904 } 905 push @$pod, $_; 906 ++$found if /^\w/; # found descriptive text 907 }
Re^2: pod-error in perldocs
by LanX (Sage) on Sep 23, 2009 at 16:08 UTC

    Whatever is splitting the entries

    IMHO parsing is done in POD::Simple, but I can't remember this bug in any older perl-versions...

    Anyway I've send an email to perl5porters reporting it and pointing back to this thread.

    If someone can spot the problem or can even supply a patch in thsi thread it should be seen!

    Anyhow I have work to do with POD::Simple next week so I'm gonna have a look...

    Cheers Rolf

    PS: @all Thanx for downvoting! 8)

      I can confirm that this error exists in 5.10.0 and that it does not exist in 5.8.4 or 5.8.8. Also, in 5.10 at least, parsing for this option occurs entirely in Pod::Perldoc, not Pod::Simple.

Log In?

What's my password?
Create A New User
Domain Nodelet?
Node Status?
node history
Node Type: note [id://797005]
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others rifling through the Monastery: (1)
As of 2021-12-08 07:23 GMT
Find Nodes?
    Voting Booth?
    R or B?

    Results (34 votes). Check out past polls.