develooper Front page | perl.perl5.porters | Postings from April 2019

Re: [perl #134036] podchecker: "*** WARNING: 1 unescaped <> inparagraph at line .. in file .."

Thread Previous
From:
Tomasz Konojacki
Date:
April 16, 2019 08:53
Subject:
Re: [perl #134036] podchecker: "*** WARNING: 1 unescaped <> inparagraph at line .. in file .."
Message ID:
20190416105251.3A62.5C4F47F8@xenu.pl
On Tue, 16 Apr 2019 01:11:59 -0700
"" Ulrich Windl " \(via RT\)" <perlbug-followup@perl.org> wrote:

> # New Ticket Created by  "Ulrich Windl" 
> # Please include the string:  [perl #134036]
> # in the subject line of all future correspondence about this issue. 
> # <URL: https://rt.perl.org/Ticket/Display.html?id=134036 >
> 
> 
> In Perl 5.18.2, "podchecker --warnings --warnings" complains on what older podchecker did not, but most importantly it complains on constructs explicitly allowed.
> 
> For example podchecker complained in these items:
>  podchecker --warnings --warnings syslogd.pl
> *** WARNING: 1 unescaped <> in paragraph at line 5180 in file syslogd.pl
> *** WARNING: 1 unescaped <> in paragraph at line 5184 in file syslogd.pl
> *** WARNING: 1 unescaped <> in paragraph at line 5188 in file syslogd.pl
> *** WARNING: 1 unescaped <> in paragraph at line 5192 in file syslogd.pl
> syslogd.pl pod syntax OK.
> 
> The lines are:
> =item B<< < >>
> =item B<< <= >>
> =item B<< > >>
> =item B<< >= >>
> 
> According to "man perlpod" the syntax above is allowed:
>        A more readable, and perhaps more "plain" way is to use an alternate
>        set of delimiters that doesn't require a single ">" to be escaped.
>        Doubled angle brackets ("<<" and ">>") may be used if and only if there
>        is whitespace right after the opening delimiter and whitespace right
>        before the closing delimiter!  For example, the following will do the
>        trick:
> 
>            C<< $a <=> $b >>

Upgrade your Pod::Simple and Pod::Checker to the latest versions and the
problem will disappear.

Thread Previous


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About