More on list variables with my and our.

See issue #1958

Author: fluca1978

doc/Language/variables.pod6

@@ -477,6 +477,13 @@ say $foo; # Exception! "Variable '$foo' is not declared"
 This dies because C<$foo> is only defined as long as we are in the same
 scope.
 
+In order to lexically scope more than one variable at the same time, surround
+the variables with parentheses:
+
+   my ( $foo, $bar );
+
+see also L<Declaring a list of variables lexically or package scoped|/variables#list_of_variables_my_our>.
+
 Additionally, lexical scoping means that variables can be temporarily
 redefined in a new scope:
 
@@ -529,12 +536,21 @@ introduce an alias into the symbol table.
 
     # Available as $M::Var here.
 
+In order to package scope more than one variable at the same time, surround
+the variables with parentheses:
+
+   our ( $foo, $bar );
+
+see also L<Declaring a list of variables lexically or package scoped|/variables#list_of_variables_my_our>.
+
+
+X<list_of_variables_my_our|Declaring a list of variables lexically (C<my>) or package (C<our>) scoped>
 =head2 Declaring a list of variables lexically (C<my>) or package (C<our>) scoped
 
 It is possible to scope more than one variable at a time, but both C<my>
 and C<our> require variables to be placed into parentheses:
 
-    my (@a, $s, %h);      # same as my @a; my $s; my %h;
+    my  (@a,  $s,  %h);   # same as my @a; my $s; my %h;
     our (@aa, $ss, %hh);  # same as our @aa; our $ss; our %hh;
 
 This can be used in conjunction with X«destructuring assignment». Any