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

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

Thread Previous | Thread Next
From:
" Ulrich Windl "
Date:
April 16, 2019 08:12
Subject:
[perl #134036] podchecker: "*** WARNING: 1 unescaped <> in paragraphat line .. in file .."
Message ID:
rt-4.0.24-15582-1555402319-1167.134036-75-0@perl.org
# 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 >>


Thread Previous | Thread Next


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