some corrections & clarifications

Author: schultzdavid

doc/Language/py-nutshell.rakudoc

@@ -32,7 +32,7 @@ Raku
     put "Hello, world!"
 
 There is also the L<say|/routine/say> keyword, which behaves similarly, but will
-call the L<gist|/routine/gist> method of its argument.
+call the L<.gist|/routine/gist> method of its argument instead of the C<.Str|/routine/Str> method.
 
 Raku
 
@@ -64,8 +64,9 @@ matching curly braces are closed.
 
 In Raku, a semicolon signifies the end of a statement.
 The semicolon may be omitted if it is the last statement
-of a block. The semicolon may also be omitted if there
-is a closing curly brace followed by a newline.
+of a block (i.e. of a list of statements enclosed in curly braces).
+The semicolon may also be omitted after a closing curly brace
+followed by a newline.
 
 Python
 
@@ -81,6 +82,7 @@ Raku
         3 + 4;
     say 1 +
         2;
+    if True { say 42 }
 
 =head2 Blocks
 
@@ -123,7 +125,7 @@ initialized or declared and initialized at once.
     $foo = 12;     # initialize
     my $bar = 19;  # both at once
 
-Also, as you may have noticed, variables in Raku usually start with sigils --
+Also, as you may have noticed, variables in Raku usually start with sigils –
 symbols indicating the type of their container. Variables starting with a C<$>
 hold scalars. Variables starting with an C<@> hold arrays, and variables
 starting with a C<%> hold a hash (dict). Sigilless variables, declared with a
@@ -398,20 +400,23 @@ I<Raku>
         say "Symbol '$symbol' stands for $element";
     }
 
-=head2 Lambdas, functions and subroutines>
+=head2 Functions, subroutines and lambdas
 
 Declaring a function (subroutine) with C<def> in Python is accomplished
 with C<sub> in Raku.
 
 =begin code :lang<python>
 def add(a, b):
     return a + b
+=end code
 
+=begin code
 sub add(\a, \b) {
     return a + b
 }
 =end code
 
+
 The C<return> is optional; the value of the last expression is used as
 the return value:
 
@@ -431,8 +436,8 @@ sub add($a, $b) {
 Python 2 functions can be called with positional arguments
 or keyword arguments.  These are determined by the caller.
 In Python 3, some arguments may be "keyword only".
-In Raku, positional and named arguments are determined
-by the signature of the routine.
+In Raku, each argument is either positional or named,
+as determined by the signature of the routine.
 
 Python