diff --git a/reference/filesystem/functions/popen.xml b/reference/filesystem/functions/popen.xml
index ea24140026..c19e181652 100644
--- a/reference/filesystem/functions/popen.xml
+++ b/reference/filesystem/functions/popen.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.popen">
    <refnamediv>
@@ -28,11 +28,19 @@
     <para>
      If an error occurs, returns &false;. 
     </para>
+    <note>
+     <para>
+      If you're looking for bi-directional support (two-way), use 
+      <function>proc_open</function>.
+     </para>
+    </note>
     <para>
      <informalexample>
       <programlisting role="php">
 <![CDATA[
+<?php
 $fp = popen ("/bin/ls", "r");
+?>
 ]]>
       </programlisting>
      </informalexample>
@@ -61,7 +69,8 @@ pclose($fp);
      </para>
     </note>
     <para>
-     See also <function>pclose</function>.
+     See also <function>pclose</function>, <function>fopen</function>,
+     and <function>proc_open</function>.
     </para>
    </refsect1>
   </refentry>