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