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
