document cross documet POD links

Raku · Oct 22, 2018 · 5ddb341 · 5ddb341
1 parent e1016a8
commit 5ddb341
Showing 1 changed file with 12 additions and 0 deletions.
diff --git a/doc/Language/pod.pod6 b/doc/Language/pod.pod6
@@ -480,6 +480,10 @@ C<my $var = 1; say $var;>
 =head2 Links
 
 To create a link enclose it in C<L< >>
+A vertical bar separates label (optional) and target.
+The target location can be an URL (first example) or
+a local POD document (second example).
+
 =for code :skip-test
 Perl 6 homepage L<https://perl6.org>
 L<Perl 6 homepage|https://perl6.org>
@@ -488,6 +492,14 @@ Perl 6 homepage L<https://perl6.org>
 
 L<Perl 6 homepage|https://perl6.org>
 
+=for code :skip-test
+Structure L</Language/about#structure>
+L<Structure|/Language/about#structure>
+
+Structure L</Language/about#structure>
+
+L<Structure|/Language/about#structure>
+
 To create a link to a section in the same document:
 =for code :skip-test
 Comments L<#Comments>