From 306a1c934975338b3cfaad8b947b582c35f0eb18 Mon Sep 17 00:00:00 2001
From: Doug Bell <madcityzen@gmail.com>
Date: Tue, 24 Nov 2015 02:31:38 -0600
Subject: [PATCH] mention $? in backticks documentation

Backticks work like system(), in that they use $? for the child exit
code. Mention that so people know to look in $? when their program
fails.
---
 pod/perlop.pod | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/pod/perlop.pod b/pod/perlop.pod
index 1691614..50ee6e0 100644
--- a/pod/perlop.pod
+++ b/pod/perlop.pod
@@ -2309,6 +2309,21 @@ when they're the right way to get something done.  Perl was made to be
 a glue language, and one of the things it glues together is commands.
 Just understand what you're getting yourself into.
 
+Like C<system>, backticks put the child process exit code in C<$?>.
+If you'd like to manually inspect failure, you can check all possible
+failure modes by inspecting C<$?> like this:
+
+    if ($? == -1) {
+        print "failed to execute: $!\n";
+    }
+    elsif ($? & 127) {
+        printf "child died with signal %d, %s coredump\n",
+            ($? & 127),  ($? & 128) ? 'with' : 'without';
+    }
+    else {
+        printf "child exited with value %d\n", $? >> 8;
+    }
+
 See L</"I/O Operators"> for more discussion.
 
 =item C<qw/I<STRING>/>
-- 
2.4.9 (Apple Git-60)