Perlpod - How to add URL links with L<>

[Jari Aalto]

[Please keep CC] According to http://perldoc.perl.org/perlpod.html the
L<> is used like:

=pod

L<<a href="http://www.perl.org/">http://www.perl.org/</a>>

=cut

But this appears to signal errors:

$ podchecker test.pod

** WARNING: node '<a href="http://www.perl.org/"' contains non-escaped | or / at line ...
*** ERROR: unresolved internal link '<a href="http://www.perl.org/"' at line ...

How it is used?

Jari

 

[Jari Aalto]

...no. L<> for arbitrary URLs is used like

L<http://www.perl.org/>

and there is no way to alter the text displayed (you always get the full
URL).

There appears to be a bug in the renderer used for perldoc.perl.org
which is causing the example to come out incorrectly. If you check the
pod source at
http://perl5.git.perl.org/perl.git/blob/HEAD:/pod/perlpod.pod or the
correctly-rendered version at
http://search.cpan.org/~dapm/perl-5.10.1/pod/perlpod.pod you will
see that the <a> stuff isn't supposed to be there. You could report a
bug to whoever maintins perldoc.perl.org.

Reported.
http://github.com/jonallen/perldoc.perl.org/issues#issue/3

Thanks,
Jari