From 2031791c7d707fa897657968a813dc9e5ae244ec Mon Sep 17 00:00:00 2001
From: Chris Wright <daverandom@php.net>
Date: Tue, 22 Oct 2013 12:04:24 +0000
Subject: [PATCH] Note that shell_exec() also returns NULL when the executed
 command produces no output. Fixes bug #65925.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@331914 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/exec/functions/shell-exec.xml | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/reference/exec/functions/shell-exec.xml b/reference/exec/functions/shell-exec.xml
index 2e41113c19..e87b88d33e 100644
--- a/reference/exec/functions/shell-exec.xml
+++ b/reference/exec/functions/shell-exec.xml
@@ -38,8 +38,17 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   The output from the executed command or &null; if an error occurred.
+   The output from the executed command or &null; if an error occurred or the
+   command produces no output.
   </para>
+  <note>
+   <para>
+    This function can return &null; both when an error occurs or the program
+    produces no output. It is not possible to detect execution failures using
+    this function. <function>exec</function> should be used when access to the
+    program exit code is required.
+   </para>
+  </note>
  </refsect1>
 
  <refsect1 role="examples">