|Keep It Simple, Stupid|
Re: hyperlinks in podby Anonymous Monk
|on Sep 27, 2011 at 19:30 UTC||Need Help??|
The vestigial <'s and >'s are ugly and confusing. They make it appear that you omitted a pod formatting code
Aside from delimiting a url in text, how else would you distinguish the beginning and end of a url in text-only console?
How would you tell these apart without delimiters?
Since angle brackets need escaping in html, folks avoid them in urls, so they make for good delimiters in a text console
This is beyond ugly. The second hyperlink has disappeared altogether.
Actually it doesn't even rise to the level of ugly, its just unsupported :) not official pod format, though this tool supports it
perl -MPod::Simple::HTML -e Pod::Simple::HTML::go hyperlink.pod hyperlink.html
It's hard for me to believe that this is a bug that has managed to go unnoticed
It hasn't gone unnoticed :) Though I don't immediately see it in https://rt.perl.org/rt3/Public/Search/Simple.html?q=pod%3A%3Ahtml/https://rt.perl.org/rt3//Public/Search/Simple.html?q=pod2html, I've seen this bug reported before, and rejected as not-a-bug, as per http://perldoc.perl.org/perlpodspec.html#About-L%3C...%3E-Codes
Authors wanting to link to a particular (absolute) URL, must do so only with "L<scheme:...>" codes (like L<http://www.perl.org>), and must not attempt "L<Some Site Name|scheme:...>" codes. This restriction avoids many problems in parsing and rendering L<...> codes.