I noticed this in perlpod yesterday:
Or you can link to a web page:
* "L<scheme:...>"
Links to an absolute URL. For example,
"L<http://www.perl.org/>". But note that there is no
corresponding "L<text|scheme:...>" syntax, for various reasons.
I've been using L<text|scheme> syntax for some time so I suspect that this
last sentence is out of date.
See proposed patch below.
Regards,
Simon Taylor
--- perlpod.pod.old 2006-09-08 16:35:24.148492712 +1000
+++ perlpod.pod 2006-09-08 16:37:45.083067400 +1000
@@ -446,9 +446,9 @@
C<LE<lt>scheme:...E<gt>>
Links to an absolute URL. For example,
-C<LE<lt>http://www.perl.org/E<gt>>. But note
-that there is no corresponding C<LE<lt>text|scheme:...E<gt>> syntax, for
-various reasons.
+"L<http://www.perl.org/>". And to display something other than
+the URL, you can use the "L<text|scheme:...>" syntax, E.g.,
+"L<See more at perl.org|http://www.perl.org/>".
=back
