Re: allowing L<text|href>

On Dec 1, 2009, at 1:54 PM, David E. Wheeler wrote:

>> For the latter, I think the best rendering for both Pod::Text and Pod::Man
>> is:
>> 
>>   perl.org <http://perl.org>
>> 
>> and that's what I plan to implement.  That's a fairly natural expression
>> of a URL in a text document and follows the IETF recommendation.
> 
> Fair enough. I can change Pod::Simple::Text to do the same.

I've now done this in Pod::Simple.

  http://github.com/theory/pod-simple/commit/1e61e819debf9c7c23907d7bb9e37855665fd595

Will be releasing in a day or so, then submitting to core. I've also updated man links output by Pod::Simple::X?HTML. Pod::Simple::HTML had been outputting them as:

    <a>crontab(5)</a>

And Pod::Simple::XHTML was outputing them as:

    <a href="">crontab(5)</a>

I found neither of these very compelling. So I poked around until I found man.he.net, which seems to have a pretty decent URL standard for man pages. So now moth modules output this link:

    <a href="http://man.he.net/man5/crontab">crontab(5)</a>

This should work most of the time, I think, but for those of you who don't want the links, you can override resolve_man_page_link() in a subclass and just have it return undef to get the original Pod::Simple::HTML format (which Pod::Simple::XHML now replicates).

Thoughts?

Best,

David