Bug#378327: Pod::Html and << >> delimiters
David Landgren
david at landgren.net
Sat Feb 13 17:51:27 UTC 2010
Niko Tyni a écrit :
> Hi David,
>
> I see you've dual-lifed Pod-Html to CPAN. The RT queue at
> http://rt.cpan.org/NoAuth/Bugs.html?Dist=Pod-Html doesn't work however,
> so I'm contacting you directly. Please let me know if you'd prefer a
> ticket at rt.perl.org or something like that.
wow, blast from the past. Sorry, this disappeared into a sub-folder.
I'll look into this, thanks for the report
David
> As reported by Jakub Wilk in <http://bugs.debian.org/378327> (Cc'd as
> 378327 at bugs.debian.org), pod2html doesn't handle multiple angled bracket
> delimiters (C<< foo >>) quite correctly.
>
> There's some misunderstanding about the problem in the bug trace, so
> just for the record: the perlpod documentation currently states
>
> 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. With the Pod formatters that are standard starting
> with perl5.5.660, 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!
>
> so I<< x >> is supposed to turn into <em>x</em> just like I<x>.
>
> I'm attaching a patch against the CPAN 1.09_4 version that includes some
> testcases failing with the current code and proposed fixes. The changes
> are pretty straightforward: the _go_ahead() function already has the
> needed logic for matching the right number of closing brackets.
>
> I had to modify t/htmlvie?.html and t/torture.html because the expected
> data in them was IMO wrong.
>
> The t/03_output change is because the diagnostics for broken
> markup changed a bit. YMMV here of course.
>
> The greedy vs. non-greedy whitespace match change is just so that empty
> delimited content works, particularly the Z<< >> test. It's IMO the only
> slightly suspicious part in this but at least the other tests don't break :)
>
> The _depod1() function looks like it could have the same problem, but I
> wasn't able to come up with a failing testcase, so I haven't touched that.
>
> Please let me know what you think.
>
> Html.pm | 23 +++++++++++--------
> MANIFEST | 2 +
> t/01_core.t | 4 ++-
> t/03_output.t | 4 +--
> t/double-angled.html | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++
> t/double-angled.pod | 34 +++++++++++++++++++++++++++++
> t/htmlviec.html | 4 +--
> t/htmlviei.html | 4 +--
> t/htmlview.html | 4 +--
> t/torture.html | 2 -
>
> Thanks for taking up Pod-Html maintenance,
>
More information about the Perl-maintainers
mailing list