[svn:perl6-synopsis] r12417 - doc/trunk/design/syn

[aud...@cvs.perl.org]

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 <la...@wall.org>
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 <la...@wall.org>
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