Author: larry
Date: Wed Dec 13 17:50:39 2006
New Revision: 13490
Modified:
doc/trunk/design/syn/S04.pod
Log:
Generalized the do/gather syntax to other similar dynamic scoping constructs.
Modified: doc/trunk/design/syn/S04.pod
==============================================================================
--- doc/trunk/design/syn/S04.pod (original)
+++ doc/trunk/design/syn/S04.pod Wed Dec 13 17:50:39 2006
@@ -12,9 +12,9 @@
Maintainer: Larry Wall <[EMAIL PROTECTED]>
Date: 19 Aug 2004
- Last Modified: 5 Dec 2006
+ Last Modified: 13 Dec 2006
Number: 4
- Version: 45
+ Version: 46
This document summarizes Apocalypse 4, which covers the block and
statement syntax of Perl.
@@ -410,7 +410,18 @@
statement or block, and executes it once. Unlike C<do>, its return
value is a specified by calling the C<take> function one or more
times within the dynamic scope of the gather. The returned values are
-flattened into a lazy list.
+flattened into a lazy list. A C<gather> is not considered a loop.
+
+Other similar C<Code>-only forms may also take bare statements,
+including C<try>, C<contend>, C<async>, and C<lazy>. These constructs
+establish a dynamic scope without necessarily establishing a lexical
+scope. (You can always establish a lexical scope explicitly by using
+the block form of argument.) As statement introducers, all these
+keywords must be followed by whitespace. You can say something
+like C<try({...})>, but then you are calling it using function call
+syntax instead, in which case the C<Code> argument must be a block.
+For purposes of flow control, none of these forms are considered loops,
+but they may easily be applied to a normal loop.
=head1 Switch statements
