Re: allowing L<text|href>

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