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

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

From:
Ulrich Windl
Date:
April 16, 2019 13:02
Subject:
Antw: Re: [perl #134036] podchecker: "*** WARNING: 1 unescaped <> inparagraph at line .. in file .."
Message ID:
5CB5CD94020000A100030CA0@gwsmtp.uni-regensburg.de
>>> "Tomasz Konojacki via RT" <perlbug-followup@perl.org> schrieb am 16.04.2019 um
10:53 in Nachricht <rt-4.0.24-3022-1555404789-1424.134036-94-0@perl.org>:
> 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.

So "false alert". Good to know.



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