Author: larry
Date: Fri Nov 21 15:16:01 2008
New Revision: 14607


various clarifications

Modified: doc/trunk/design/syn/S02.pod
--- doc/trunk/design/syn/S02.pod        (original)
+++ doc/trunk/design/syn/S02.pod        Fri Nov 21 15:16:01 2008
@@ -12,9 +12,9 @@
   Maintainer: Larry Wall <[EMAIL PROTECTED]>
   Date: 10 Aug 2004
-  Last Modified: 7 Nov 2008
+  Last Modified: 19 Nov 2008
   Number: 2
-  Version: 142
+  Version: 143
 This document summarizes Apocalypse 2, which covers small-scale
 lexical items and typological issues.  (These Synopses also contain
@@ -911,6 +911,16 @@
     Capture     Function call arguments (right-hand side of a binding)
     Blob        An undifferentiated mass of bits
+Insofar as Lists are lazy, they're really only partially immutable, in
+the sense that the past is fixed but the future is not.  The portion of
+a List yet to be determined by iterators may depend on mutable values.
+When an iterator is called upon to iterate and extend the known part
+of the list, some number of immutable values (which includes immutable
+references to mutable objects) are decided and locked in at that point.
+Iterators may have several different ways of iterating depending on
+the degree of laziness/eagerness desired in context.  The iterator
+API is described in S07.
 =head2 Mutable types
 Objects with these types have distinct C<.WHICH> values that do not change
@@ -3226,7 +3236,7 @@
     string      buf     Str     ~
 There are also various container contexts that require particular kinds of
+containers (such as slice and hash context; see S03 for details).
 =item *

Modified: doc/trunk/design/syn/S06.pod
--- doc/trunk/design/syn/S06.pod        (original)
+++ doc/trunk/design/syn/S06.pod        Fri Nov 21 15:16:01 2008
@@ -13,9 +13,9 @@
   Maintainer: Larry Wall <[EMAIL PROTECTED]>
   Date: 21 Mar 2003
-  Last Modified: 14 Oct 2008
+  Last Modified: 21 Nov 2008
   Number: 6
-  Version: 96
+  Version: 97
 This document summarizes Apocalypse 6, which covers subroutines and the
@@ -1530,6 +1530,12 @@
 Placeholders may also be used in method bodies that have no formal signature.
+Since the placeholder declares a parameter variable without the twigil,
+the twigil is needed only on the first occurence of the variable within
+the block.  Subsequent mentions of that variable may omit the twigil.
+Within an internal nested block the twigil I<must> be omitted, since
+it would wrongly attach to the inner block.
 =head1 Properties and traits
 Compile-time properties are called "traits". The 

Reply via email to