Re: [perl #2562] wantarray fails in END, INIT, and CHECK blocks

Message-ID: <E1Ccq7V-00057s-9s@virgo.cus.cam.ac.uk>

p4raw-id: //depot/perl@23639

diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index 76fd640..dec40d7 100644 (file)
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -6731,7 +6731,7 @@ and for other examples.
 =item wantarray
 
 Returns true if the context of the currently executing subroutine or
-eval() block is looking for a list value.  Returns false if the context is
+C<eval> is looking for a list value.  Returns false if the context is
 looking for a scalar.  Returns the undefined value if the context is
 looking for no value (void context).
 
@@ -6739,6 +6739,10 @@ looking for no value (void context).
     my @a = complex_calculation();
     return wantarray ? @a : "@a";
 
+C<wantarray()>'s result is unspecified in the top level of a file,
+in a C<BEGIN>, C<CHECK>, C<INIT> or C<END> block, or in a C<DESTROY>
+method.
+
 This function should have been named wantlist() instead.
 
 =item warn LIST