Update the description of the 'system' function to point users at autodie
authorJesse Vincent <jesse@bestpractical.com>
Mon, 3 Aug 2009 11:06:00 +0000 (12:06 +0100)
committerDavid Mitchell <davem@iabyn.com>
Mon, 3 Aug 2009 22:20:17 +0000 (23:20 +0100)
pjf++ for complaining about the POD for system during his Klingon
Programming talk at YAPC::EU 2009

(cherry picked from commit 1af1c0d6fc56624ceeee486b9d34f20643ac0ecd)

pod/perlfunc.pod

index bf22584..b3c076d 100644 (file)
@@ -6455,6 +6455,9 @@ C<qx//>, as described in L<perlop/"`STRING`">.  Return value of -1
 indicates a failure to start the program or an error of the wait(2) system
 call (inspect $! for the reason).
 
+If you'd like to make C<system> (and many other bits of Perl) die on error,
+have a look at the L<autodie> pragma.
+
 Like C<exec>, C<system> allows you to lie to a program about its name if
 you use the C<system PROGRAM LIST> syntax.  Again, see L</exec>.
 
@@ -6467,8 +6470,8 @@ value.
     system(@args) == 0
         or die "system @args failed: $?"
 
-You can check all the failure possibilities by inspecting
-C<$?> like this:
+If you'd like to manually inspect C<system>'s failure, u can check all
+possible failure modes by inspecting C<$?> like this:
 
     if ($? == -1) {
        print "failed to execute: $!\n";