Author: larry
Date: Tue Mar 6 21:34:30 2007
New Revision: 14312
Modified:
doc/trunk/design/syn/S02.pod
Log:
Some clarifications and oversights noted by TheDamian++.
The &foo\($bar) shorthand for &foo.assuming($bar) is now gone.
Modified: doc/trunk/design/syn/S02.pod
==============================================================================
--- doc/trunk/design/syn/S02.pod (original)
+++ doc/trunk/design/syn/S02.pod Tue Mar 6 21:34:30 2007
@@ -12,9 +12,9 @@
Maintainer: Larry Wall <[EMAIL PROTECTED]>
Date: 10 Aug 2004
- Last Modified: 28 Feb 2007
+ Last Modified: 6 Feb 2007
Number: 2
- Version: 91
+ Version: 92
This document summarizes Apocalypse 2, which covers small-scale
lexical items and typological issues. (These Synopses also contain
@@ -1238,11 +1238,7 @@
&foo:(Int,Num)
It still just returns a C<Code> object. A call may also be partially
-applied by using an argument list literal as a postfix operator:
-
- &foo\(1,2,3,:mice<blind>)
-
-This is really just a shorthand for
+applied by using the C<.assuming> method:
&foo.assuming(1,2,3,:mice<blind>)
@@ -1573,6 +1569,8 @@
Standard input is C<$*IN>, standard output is C<$*OUT>, and standard error
is C<$*ERR>. The magic command-line input handle is C<$*ARGS>.
+The arguments themselves come in C<@*ARGS>. See also "Declaring a MAIN
+subroutine" in S06.
=item *
@@ -1907,7 +1905,7 @@
a => %a :%a
a => $$a :$$a
a => @$$a :@$$a (etc.)
- a => %foo<a> %foo:<a>
+ a => %foo<a> %foo<a>:p
Note that as usual the C<{...}> form can indicate either a closure or a hash
depending on the contents. It does I<not> indicate a subscript.
@@ -2450,8 +2448,8 @@
or as an array via C<@=DATA>. Presumably a module could read all
its COMMENT blocks from C<@=COMMENT>, for instance. Each chunk of
pod comes as a separate array element. You have to split it into lines
-yourself. Each chunk has a C<.linenum> property that indicates its
-starting line within the source file.
+yourself. Each chunk has a C<.range> property that indicates its
+line number range within the source file.
The lexical routine itself is C<&?ROUTINE>; you can get its name with
C<&ROUTINE.name>. The current block is C<&?BLOCK>. If the block has a label,