diff --git a/reference/exec/functions/shell-exec.xml b/reference/exec/functions/shell-exec.xml
index f296588a7a..b5bd62cb87 100644
--- a/reference/exec/functions/shell-exec.xml
+++ b/reference/exec/functions/shell-exec.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/exec.xml, last change in rev 1.2 -->
   <refentry id='function.shell-exec'>
    <refnamediv>
@@ -18,7 +18,26 @@
      This function is identical to the <link
      linkend="language.operators.execution">backtick operator</link>.
     </para>
+    <para>
+     <example>
+      <title>A <function>shell_exec</function> example</title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+$output = shell_exec('ls -lart');
+echo "<pre>$output</pre>";
+?>
+]]>
+      </programlisting>
+     </example>
+    </para>
+         
     &note.sm.disabled;
+
+    <para>
+     See also <function>exec</function> and
+     <function>escapeshellcmd</function>.
+    </para>
    </refsect1>
   </refentry>