cvs: phpdoc /en/functions filesystem.xml

torben Sat Feb 9 18:44:43 2002 EDT Modified files: /phpdoc/en/functions filesystem.xml Log: Closes bug #14621. Index: phpdoc/en/functions/filesystem.xml diff -u phpdoc/en/functions/filesystem.xml:1.117 phpdoc/en/functions/filesystem.xml:1.118 --- phpdoc/en/functions/filesystem.xml:1.117 Sat Feb 9 16:48:38 2002 +++ phpdoc/en/functions/filesystem.xml Sat Feb 9 18:44:43 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.117 $ --> +<!-- $Revision: 1.118 $ --> <reference id="ref.filesystem"> <title>Filesystem functions</title> <titleabbrev>Filesystem</titleabbrev> @@ -2348,7 +2348,7 @@ <function>fputs</function>. </para> <para> - If an error occurs, returns &false;. + If an error occurs, returns &false;. </para> <para> <informalexample> @@ -2359,6 +2359,29 @@ </programlisting> </informalexample> </para> + <note> + <para> + If the command to be executed could not be found, a valid + resource is returned. This may seem odd, but makes sense; it + allows you to access any error message returned by the shell: + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +error_reporting(E_ALL); + +/* Add redirection so we can get stderr. */ +$fp = popen('/path/to/spooge 2>&1', 'r'); +echo "'$fp'; " . gettype($fp) . "\n"; +$read = fread($fp, 2096); +echo $read; +pclose($fp); +?> +]]> + </programlisting> + </informalexample> + </para> + </note> <para> See also <function>pclose</function>. </para>