Author: larry
Date: Sun Jan 27 14:49:15 2008
New Revision: 14496

Modified:
   doc/trunk/design/syn/S03.pod

Log:
Clarify range ending semantics for autoincrement sequences that will never 
match the "to"


Modified: doc/trunk/design/syn/S03.pod
==============================================================================
--- doc/trunk/design/syn/S03.pod        (original)
+++ doc/trunk/design/syn/S03.pod        Sun Jan 27 14:49:15 2008
@@ -12,9 +12,9 @@
 
   Maintainer: Larry Wall <[EMAIL PROTECTED]>
   Date: 8 Mar 2004
-  Last Modified: 22 Jan 2008
+  Last Modified: 27 Jan 2008
   Number: 3
-  Version: 127
+  Version: 128
 
 =head1 Overview
 
@@ -2525,6 +2525,16 @@
 An empty Range cannot be iterated; it returns a C<Failure> instead.  An empty
 range still has a defined min and max, but the min is greater than the max.
 
+If a range is generated using a magical autoincrement, it stops if the magical
+increment would "carry" and make the next value longer than the "to" value, on 
the
+assumption that the sequence can never match the final value exactly.  Hence,
+all of these produce 'A' .. 'Z':
+
+    'A' .. 'Z'
+    'A' .. 'z'
+    'A' .. '_'
+    'A' .. '~'
+
 =item *
 
 The unary C<^> operator generates a range from C<0> up to

Reply via email to