Author: larry
Date: Fri Nov 21 15:16:01 2008
New Revision: 14607
Modified:
doc/trunk/design/syn/S02.pod
doc/trunk/design/syn/S06.pod
Log:
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.
+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
