doc multidim literal lists

Author: gfldex

doc/Language/list.pod6

@@ -6,24 +6,33 @@
 
 Lists have been a central part of computing since before there
 were computers, during which time many devils have taken up residence in
-their details.  They were actually one of the hardest parts of Perl 6
+their details. They were actually one of the hardest parts of Perl 6
 to design, but through persistence and patience, Perl 6 has arrived with
 an elegant system for handling them.
 
 =head1 Literal Lists
 
-Literal L<C<List>s|/type/List> are created with commas B<not> with
-parentheses, so:
+Literal L<C<List>s|/type/List> are created with commas and semicolons B<not>
+with parentheses, so:
 
     1, 2        # This is two-element list
-    (1, 2)      # This is also a list, in parentheses
-    (1)         # This is not a list, just a 1 in parentheses
-    (1,)        # This is a one-element list
+    (1, 2)      # This is also a List, in parentheses
+    (1; 2)      # same List
+    (1)         # This is not a List, just a 1 in parentheses
+    (1,)        # This is a one-element List
 
-Parentheses can be used to mark the beginning and end of a list, so:
+Parentheses can be used to mark the beginning and end of a C<List>, so:
 
     (1, 2), (1, 2) # This is a list of two lists.
 
+Multidimensional literal C<List>s are created combining comma and semicolon.
+They can be used in routine argument lists and subscripts.
+
+    say so (1,2; 3,4) eqv ((1,2), (3,4));
+    # OUTPUT«True␤»
+    say('foo';); # a list with one element and the empty list
+    # OUTPUT«(foo)()␤»
+
 Individual elements can be pulled out of a list using a subscript.  The
 first element of a list is at index number zero: