Author: larry
Date: Fri Aug 3 18:27:52 2007
New Revision: 14432
Modified:
doc/trunk/design/syn/S05.pod
doc/trunk/design/syn/S06.pod
Log:
Clarification of meaning of <foo: string> form as non-interpolating
Restriction of placeholder names to lowercase to help us catch $^O et al.
Modified: doc/trunk/design/syn/S05.pod
==============================================================================
--- doc/trunk/design/syn/S05.pod (original)
+++ doc/trunk/design/syn/S05.pod Fri Aug 3 18:27:52 2007
@@ -14,9 +14,9 @@
Maintainer: Patrick Michaud <[EMAIL PROTECTED]> and
Larry Wall <[EMAIL PROTECTED]>
Date: 24 Jun 2002
- Last Modified: 10 Jul 2007
+ Last Modified: 3 Jul 2007
Number: 5
- Version: 61
+ Version: 62
This document summarizes Apocalypse 5, which is about the new regex
syntax. We now try to call them I<regex> rather than "regular
@@ -1000,7 +1000,8 @@
<foo: bar>
-To pass a string with leading whitespace you must use the parenthesized form.
+To pass a string with leading whitespace, or to interpolate any values
+into the string, you must use the parenthesized form.
If the first character is a plus or minus, the initial identifier
is taken as a character class, so the first character after the
Modified: doc/trunk/design/syn/S06.pod
==============================================================================
--- doc/trunk/design/syn/S06.pod (original)
+++ doc/trunk/design/syn/S06.pod Fri Aug 3 18:27:52 2007
@@ -13,9 +13,9 @@
Maintainer: Larry Wall <[EMAIL PROTECTED]>
Date: 21 Mar 2003
- Last Modified: 2 Jun 2007
+ Last Modified: 3 Aug 2007
Number: 6
- Version: 88
+ Version: 89
This document summarizes Apocalypse 6, which covers subroutines and the
@@ -1397,6 +1397,8 @@
Note that placeholder variables syntactically cannot have type constraints.
Also, it is illegal to use placeholder variables in a block that already
has a signature, because the autogenerated signature would conflict with that.
+Placeholder names may only be lowercase, not because we're mean, but
+because it helps us catch references to obsolete Perl 5 variables such as $^O.
=head1 Properties and traits
