This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlvar: Correct $^S’s description
authorFather Chrysostomos <sprout@cpan.org>
Sun, 29 Jul 2012 20:30:35 +0000 (13:30 -0700)
committerFather Chrysostomos <sprout@cpan.org>
Sun, 29 Jul 2012 20:30:35 +0000 (13:30 -0700)
pod/perlvar.pod

index da02cc6..9a6201c 100644 (file)
@@ -1607,14 +1607,18 @@ X<$^S> X<$EXCEPTIONS_BEING_CAUGHT>
 Current state of the interpreter.
 
        $^S         State
-       ---------   -------------------
-       undef       Parsing module/eval
+       ---------   -------------------------------------
+       undef       Parsing module, eval, or main program
        true (1)    Executing an eval
        false (0)   Otherwise
 
 The first state may happen in C<$SIG{__DIE__}> and C<$SIG{__WARN__}>
 handlers.
 
+The English name $EXCEPTIONS_BEING_CAUGHT is slightly misleading, because
+the C<undef> value does not indicate whether exceptions are being caught,
+since compilation of the main program does not catch exceptions.
+
 This variable was added in Perl 5.004.
 
 =item $WARNING