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)
committerJesse Vincent <jesse@bestpractical.com>
Mon, 3 Aug 2009 11:09:17 +0000 (12:09 +0100)
pjf++ for complaining about the POD for system during his Klingon
Programming talk at YAPC::EU 2009

pod/perlfunc.pod

index 3a345aa..9f95bb0 100644 (file)
@@ -6474,6 +6474,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>.
 
@@ -6486,8 +6489,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";