@@ -13,7 +13,7 @@ elegant system for handling them.
1313=head1 Literal lists
1414
1515Literal L<C<List>|/type/List>s are created with commas and semicolons, B<not>
16- with parentheses, so:
16+ with parentheses (which only group things) , so:
1717
1818 1, 2; # This is two-element list
1919 our $list = (1, 2); # This is also a List, in parentheses
@@ -96,7 +96,7 @@ instead.
9696One of the ways C<@>-sigiled variables act like lists is by always supporting
9797L<positional subscripting|/language/subscripts>. Anything bound to an
9898C<@>-sigiled value must support the L<C<Positional>|/type/Positional> role which
99- guarantees that this is going to fail:
99+ guarantees that the following is going to fail:
100100
101101 my @a := 1; # Type check failed in binding; expected Positional but got Int
102102
@@ -166,7 +166,7 @@ would expect>.
166166
167167This rule is equivalent to saying that arguments to iterators will not
168168flatten, will not de-containerize, and will behave as if a single argument
169- has been handled to them, whatever the shape that argument has.
169+ has been handed to them, whatever the shape that argument has.
170170
171171=for code
172172my @a = 1,2; .say for @a, |@a; # OUTPUT: «[1 2]12»
@@ -175,7 +175,7 @@ my @a = 1,2; .say for $[@a, |@a ]; # OUTPUT: «[[1 2] 1 2]»
175175In the second case, the single argument is a single element, since we have
176176itemized the array. There's an exception to the single argument rule
177177L<mentioned in the Synopsis|https://github.com/Raku/old-design-docs/blob/master/S07-lists.pod#The_single_argument_rule>:
178- list or arrays with a single element will be flattened:
178+ lists or arrays with a single element will be flattened:
179179
180180=for code
181181my @a = 1,2; .say for [[@a ]]; # OUTPUT: «12»
@@ -748,12 +748,12 @@ as a courtesy to their users:
748748=item Use L<C<Slip>|/type/Slip>s when you want to always merge with surrounding lists.
749749=item Use non-itemized lists when you want to make it easy for the user to flatten.
750750=item Use itemized lists to protect things the user probably will not want flattened.
751- =item Use L<C<Array>|/type/Array>s as non-itemized lists of itemized lists, if appropriate.
751+ =item Use L<C<Array>|/type/Array>s as non-itemized lists of itemized lists, if appropriate. (E.g. C<[$(1, 2), $(3, 4)]>.)
752752=item Use L<C<Array>|/type/Array>s if the user is going to want to mutate the result without copying it first.
753753
754754The fact that all elements of an array are itemized (in L<C<Scalar>|/type/Scalar>
755755containers) is more a gentleman's agreement than a universally enforced
756- rule, and it is less well enforced that typechecks in typed arrays. See
756+ rule, and it is less well enforced than typechecks in typed arrays. See
757757the section below on binding to Array slots.
758758
759759=head2 Literal arrays
0 commit comments