On Dec 1, 2009, at 1:09 PM, John McNamara wrote:
> This should be implemented without a doubt.
>
> Just to note however that Pod::Simple::HTML and (and by extension
> search.cpan.org) currently convert this link:
>
> =pod
>
> This is a link to L<Perl|http://perl.org>.
>
> =cut
>
>
> To this:
>
> <p>This is a link to <a
> href="http://search.cpan.org/perldoc?http%3A#%2Fperl.org"
> class="podlinkpod">Perl</a>.</p>
Um, no it doesn't. I just wrote a test for this:
ok(
x(qq{L<perl.org|http://www.perl.org>\n}),
qq{\n<p><a href=\"http://www.perl.org\"
class=\"podlinkurl\"\n>perl.org</a></p>\n}
);
That passes.
OTOH, Pod::Simple::XHTML is broken when it comes to man page links:
ok(
x(qq{L<crontab(5)>\n}),
qq{\n<p><a>crontab(5)</a></p>\n} # XXX WRONG!
);
I'm thinking maybe manpage links should go to some reliable Web site that has
man pages. Anyone got any suggestions?
Best,
David