simon | 7 Sep 2006 15:53
Picon

perlpod and the L<text|name> syntax

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
 <at>  <at>  -446,9 +446,9  <at>  <at> 
 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.,
(Continue reading)


Gmane