Author: audreyt Date: Mon Sep 25 20:49:59 2006 New Revision: 12417 Modified: doc/trunk/design/syn/S02.pod doc/trunk/design/syn/S04.pod
Log: * S02: Introduce the :$$x form in adverbial pair parsing. * S02/S04: Canonicalize "item" as the unary context enforcer, so that the name "Scalar" can unabiguous mean the mutable container class. Modified: doc/trunk/design/syn/S02.pod ============================================================================== --- doc/trunk/design/syn/S02.pod (original) +++ doc/trunk/design/syn/S02.pod Mon Sep 25 20:49:59 2006 @@ -12,9 +12,9 @@ Maintainer: Larry Wall <[EMAIL PROTECTED]> Date: 10 Aug 2004 - Last Modified: 25 Sept 2006 + Last Modified: 26 Sept 2006 Number: 2 - Version: 72 + Version: 73 This document summarizes Apocalypse 2, which covers small-scale lexical items and typological issues. (These Synopses also contain @@ -1481,6 +1481,8 @@ a => $a :$a a => @a :@a a => %a :%a + a => $$a :$$a + a => @$$a :@$$a (etc.) a => %foo<a> %foo:<a> Note that as usual the C<{...}> form can indicate either a closure or a hash @@ -2142,6 +2144,8 @@ really does exactly the same thing as putting a list in parentheses with at least one comma. But it's more readable in some situations.) +To force a non-flattening scalar context, use the "C<item>" operator. + =item * The C<|> prefix operator may be used to force "capture" context on its Modified: doc/trunk/design/syn/S04.pod ============================================================================== --- doc/trunk/design/syn/S04.pod (original) +++ doc/trunk/design/syn/S04.pod Mon Sep 25 20:49:59 2006 @@ -12,9 +12,9 @@ Maintainer: Larry Wall <[EMAIL PROTECTED]> Date: 19 Aug 2004 - Last Modified: 24 Sep 2006 + Last Modified: 26 Sep 2006 Number: 4 - Version: 40 + Version: 41 This document summarizes Apocalypse 4, which covers the block and statement syntax of Perl. @@ -933,7 +933,7 @@ and not care about whether the function is being called in scalar or list context. To return an explicit scalar undef, you can always say - return scalar(undef); + return item(undef); Then in list context, you're returning a list of length 1, which is defined (much like in Perl 5). But generally you should be using