summaryrefslogtreecommitdiff
path: root/pod
diff options
context:
space:
mode:
authorRicardo Signes <rjbs@cpan.org>2009-12-07 18:19:28 -0500
committerRafael Garcia-Suarez <rgs@consttype.org>2009-12-08 10:59:48 +0100
commitf6e963e4dd62b8e3c01b31f4a4dd57e47e104997 (patch)
tree4beee89789bb73a2ceaf238fd1b7070e1ee1e504 /pod
parenta92c0cd070f2017820463754d4257b62b59c1e05 (diff)
downloadperl-f6e963e4dd62b8e3c01b31f4a4dd57e47e104997.tar.gz
remove prohibition against L<text|href>
Diffstat (limited to 'pod')
-rw-r--r--pod/perlpod.pod8
-rw-r--r--pod/perlpodspec.pod8
2 files changed, 12 insertions, 4 deletions
diff --git a/pod/perlpod.pod b/pod/perlpod.pod
index 827548b8eb..5e2121dd2a 100644
--- a/pod/perlpod.pod
+++ b/pod/perlpod.pod
@@ -446,10 +446,10 @@ Or you can link to a web page:
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.
+C<LE<lt>text|scheme:...E<gt>>
+
+Links to an absolute URL. For example, C<LE<lt>http://www.perl.org/E<gt>> or
+C<LE<lt>The Perl Home Page|http://www.perl.org/E<gt>>.
=back
diff --git a/pod/perlpodspec.pod b/pod/perlpodspec.pod
index 8973a7080c..537f29ad70 100644
--- a/pod/perlpodspec.pod
+++ b/pod/perlpodspec.pod
@@ -1208,6 +1208,14 @@ For example:
'url', # what sort of link
"http://www.perl.org/" # original content
+ L<Perl.org|http://www.perl.org/>
+ => "Perl.org", # link text
+ "http://www.perl.org/", # possibly inferred link text
+ "http://www.perl.org/", # name
+ undef, # section
+ 'url', # what sort of link
+ "Perl.org|http://www.perl.org/" # original content
+
Note that you can distinguish URL-links from anything else by the
fact that they match C<m/\A\w+:[^:\s]\S*\z/>. So
C<LE<lt>http://www.perl.comE<gt>> is a URL, but