Merge pull request #3066 from uzluisf/master

Wrap inline code examples with C<>, remove unneeded capitalization, ...

Author: Altai-man

doc/Language/5to6-nutshell.pod6

@@ -69,7 +69,7 @@ how identifiers are defined.
 =head2 Identifiers
 
 Raku allows the use of dashes (C<->), underscores (C<_>),
-apostrophes (C<'>), and alphanumerics in identifiers, :
+apostrophes (C<'>), and alphanumerics in identifiers:
 
     sub test-doesn't-hang { ... }
     my $ความสงบ = 42;
@@ -223,8 +223,8 @@ name.
 The C<$> sigil is now always used with "scalar" variables (e.g. C<$name>),
 and no longer for L<array indexing|#[]_Array_indexing/slicing> and L<Hash
 indexing|#{}_Hash_indexing/slicing>.  That is, you can still use C<$x[1]>
-and C<$x{"foo"}>, but it will act on $x, with no effect on a similarly
-named @x or %x. Those would now be accessed with @x[1] and %x{"foo"}.
+and C<$x{"foo"}>, but it will act on C<$x>, with no effect on a similarly
+named C<@x> or C<%x>. Those would now be accessed with C<@x[1]> and C<%x{"foo"}>.
 
 =head3 C<@> Array
 
@@ -465,8 +465,8 @@ my @array = 4,8,15;
 say @array; #  OUTPUT: «[66 8 15]␤»
 =end code
 
-The underlying Array object of C<@array> is passed, and its first value modified
-inside the declared routine.
+The underlying C<Array> object of C<@array> is passed, and its first value
+modified inside the declared routine.
 
 In Perl 5, the syntax for dereferencing an entire reference is the type-sigil
 and curly braces, with the reference inside the curly braces. In Raku, this
@@ -546,7 +546,7 @@ my @all_numbers = |@numbers, 400, |@more_numbers;
 That way one can concatenate arrays.
 
 Note that one does not need to have any parentheses on the right-hand side:
-the List Separator takes care of creating the list, B<not> the parentheses!
+the list separator takes care of creating the list, B<not> the parentheses!
 
 =head2 C«<=> cmp» Three-way comparisons
 
@@ -677,13 +677,13 @@ $food = 'grape' ~ 'fruit'; # Raku
 
 =head2 C<x> List repetition or string repetition operator
 
-In Perl 5, C<x> is the Repetition operator, which behaves differently in
+In Perl 5, C<x> is the repetition operator, which behaves differently in
 scalar or list contexts:
 =item in scalar context C<x> repeats a string;
 =item in list context C<x> repeats a list, but only if the left argument
 is parenthesized!
 
-Raku uses two different Repetition operators to achieve the above:
+Raku uses two different repetition operators to achieve the above:
 =item C<x> for string repetitions (in any context);
 =item C<xx> for list repetitions (in any context).
 
@@ -745,7 +745,7 @@ it does not allow for an C<elsif> or C<else> clause.
 =head3 C<given>-C<when>
 
 The C<given>-C<when> construct is like a chain of C<if>-C<elsif>-C<else>
-statements or like the C<switch>-C<case> construct in e.g. C.  It has the
+statements or like the C<switch>-C<case> construct C, for example.  It has the
 general structure:
 
 =for code :lang<pseudo>
@@ -880,8 +880,8 @@ for (@cars)      {...} # Perl 5; $_ is read-write
 for @cars        {...} # Raku; $_ is read-write
 for @cars <-> $_ {...} # Raku; $_ is also read-write
 
-It is possible to consume more than one element of the list in each iteration simply specifying
-more than one variable after the arrow operator:
+It is possible to consume more than one element of the list in each iteration
+simply specifying more than one variable after the arrow operator:
 
 =begin code
 my @array = 1..10;
@@ -890,6 +890,17 @@ for @array -> $first, $second {
 }
 =end code
 
+For cases in which the number of elements iterated over isn't a multiple
+of the number of variables after the arrow operator, you can provide variables
+with default values:
+
+=begin code
+my @array = 1..9;
+for @array -> $first, $second = 0 {
+    say "First is $first, second is $second";
+}
+=end code
+
 =head4 C<each>
 
 Here is the equivalent to Perl 5’s C<while…each(%hash)> or C<while…each(@array)>