Author: larry Date: Wed Jul 16 23:52:23 2008 New Revision: 14566 Modified: doc/trunk/design/syn/S04.pod
Log: suggestion from moritz++ that POST blocks be allowed to see the return value Modified: doc/trunk/design/syn/S04.pod ============================================================================== --- doc/trunk/design/syn/S04.pod (original) +++ doc/trunk/design/syn/S04.pod Wed Jul 16 23:52:23 2008 @@ -14,7 +14,7 @@ Date: 19 Aug 2004 Last Modified: 16 July 2008 Number: 4 - Version: 67 + Version: 68 This document summarizes Apocalypse 4, which covers the block and statement syntax of Perl. @@ -1060,6 +1060,14 @@ before C<BEGIN>, C<CHECK>, or C<INIT>, since those are done at compile or process initialization time). +For blocks such as C<KEEP> and C<POST> that are run when exiting a +scope normally, the return value (if any) from that scope is available +as the current topic. (It is presented as a C<Capture> object.) +The topic of the outer block is still available as C<< OUTER::<$_> >>. +Whether the return value is modifiable may be a policy of the block +in question. In particular, the return value should not be modified +within a C<POST> block, but a C<LEAVE> block could be more liberal. + =head1 Statement parsing In this statement: