[svn:perl6-synopsis] r10478 - doc/trunk/design/syn

Author: audreyt
Date: Wed Jul 26 07:21:13 2006
New Revision: 10478

Modified:
   doc/trunk/design/syn/S04.pod
   doc/trunk/design/syn/S06.pod

Log:
* S04, S06: "Pointy sub" and "Pointy block" was used
  interchangeably in the text, but as uri++ pointed out,
  it was very confusing as we also say that "return" escapes
  from subs but not blocks.
  
  Hence, rename all mention of "pointy sub" to "pointy block".

Modified: doc/trunk/design/syn/S04.pod
==============================================================================
--- doc/trunk/design/syn/S04.pod	(original)
+++ doc/trunk/design/syn/S04.pod	Wed Jul 26 07:21:13 2006
@@ -14,7 +14,7 @@
   Date: 19 Aug 2004
   Last Modified: 26 July 2006
   Number: 4
-  Version: 30
+  Version: 31
 
 This document summarizes Apocalypse 4, which covers the block and
 statement syntax of Perl.
@@ -488,7 +488,7 @@
 
 A C<return> always exits from the lexically surrounding sub
 or method definition (that is, from a function officially declared
-with the C<sub>, C<method>, or C<submethod> keywords).  Pointy subs
+with the C<sub>, C<method>, or C<submethod> keywords).  Pointy blocks
 and bare closures are transparent to C<return>.  If you pass a closure
 object outside of its official "sub" scope, it is illegal to
 return from it.  You may only leave the closure block itself with C<leave>

Modified: doc/trunk/design/syn/S06.pod
==============================================================================
--- doc/trunk/design/syn/S06.pod	(original)
+++ doc/trunk/design/syn/S06.pod	Wed Jul 26 07:21:13 2006
@@ -15,7 +15,7 @@
   Date: 21 Mar 2003
   Last Modified: 26 July 2006
   Number: 6
-  Version: 41
+  Version: 42
 
 
 This document summarizes Apocalypse 6, which covers subroutines and the
@@ -132,13 +132,13 @@
 it is considered the final element of that list unless followed immediately
 by a comma or comma surrogate.
 
-=head2 "Pointy subs"
+=head2 "Pointy blocks"
 
 Semantically the arrow operator C<< -> >> is almost a synonym for
 the anonymous C<sub> keyword, except that the parameter list of a
-pointy sub does not require parentheses, and a pointy sub may not be
-given traits.  Syntactically a pointy sub is parsed exactly like a
-bare block.
+pointy block does not require parentheses, and a pointy block may not be
+given traits.  Syntactically, a pointy block is parsed exactly like a
+bare block:
 
     my $sq = -> $val { $val**2 };
     say $sq(10); # 100
@@ -149,7 +149,7 @@
     }
 
 It also behaves like a block with respect to control exceptions.  If you
-C<return> from within a pointy sub, it will return from the innermost
+C<return> from within a pointy block, it will return from the innermost
 enclosing C<sub> or C<method>, not the block itself.  It is referenced
 by C<&?BLOCK>, not C<&?ROUTINE>.
 

• [svn:perl6-synopsis] r10478 - doc/trunk/design/syn by audreyt