develooper Front page | perl.perl5.porters | Postings from January 2012

Deprecation of alternate text in hyperlinks

Thread Next
From:
Karl Williamson
Date:
January 23, 2012 08:06
Subject:
Deprecation of alternate text in hyperlinks
Message ID:
4F1D8573.5040402@khwilliamson.com
Version 1.50 of Pod::Parser adds a check and message indicating that 
L<text|hyperlink> is deprecated.  This is based on the following 
sentences in perlpodspec, which has been there since its inception in 2001:

"Authors wanting to link to a particular (absolute) URL, must do so
only with "LE<lt>scheme:...>" codes (like
LE<lt>http://www.perl.org>), and must not attempt "LE<lt>Some Site
Name|scheme:...>" codes.  This restriction avoids many problems
in parsing and rendering LE<lt>...> codes."

Elsewhere in the document, it says that the handler should handle these, 
as in the example

  L<Perl.org|http://www.perl.org/>

The new Pod:Parser has just been installed in blead, and about 10 pods 
run afoul of this new check, including things like

L<perlbug@perl.org|mailto:perlbug@perl.org>

My question is should there really be a message for this kind of use, 
and if so, should it extend to mailto: links?

Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About