Re: cvs: phpdoc /en/functions filesystem.xml
| From: | Andrew L. | Date: | Sun, 10 Feb 2002 01:00:11 +0000 |
| Subject: | Re: cvs: phpdoc /en/functions filesystem.xml | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969342169@lists.php.net to get a copy of this message | ||
I'm running PHP/4.1.1 and I get warning messages if I don't include the
second param. Am I missing something?
On Saturday 09 February 2002 06:38 pm, Torben Wilson wrote:
> torben Sat Feb 9 19:38:40 2002 EDT
>
> Modified files:
> /phpdoc/en/functions filesystem.xml
> Log:
> Reverting this; the second parameter is indeed optional in versions
> newer than 4.1.0 (also added a note to this effect).
>
>
> Index: phpdoc/en/functions/filesystem.xml
> diff -u phpdoc/en/functions/filesystem.xml:1.119
> phpdoc/en/functions/filesystem.xml:1.120 ---
> phpdoc/en/functions/filesystem.xml:1.119 Sat Feb 9 19:18:53 2002 +++
> phpdoc/en/functions/filesystem.xml Sat Feb 9 19:38:40 2002
> @@ -1,5 +1,5 @@
> <?xml version="1.0" encoding="iso-8859-1"?>
> -<!-- $Revision: 1.119 $ -->
> +<!-- $Revision: 1.120 $ -->
> <reference id="ref.filesystem">
> <title>Filesystem functions</title>
> <titleabbrev>Filesystem</titleabbrev>
> @@ -556,7 +556,7 @@
> <methodsynopsis>
> <type>string</type><methodname>fgets</methodname>
>
> <methodparam><type>int</type><parameter>fp</parameter></methodparam>
> -
>
> <methodparam><type>int</type><parameter>length</parameter></methodparam>
> +
> <methodparam
>
> choice="opt"><type>int</type><parameter>length</parameter></methodparam>
> </methodsynopsis>
> <para>
> Returns a string of up to length - 1 bytes read from the file
> @@ -572,8 +572,8 @@
> Common Pitfalls:
> </para>
> <simpara>
> - People used to the 'C' semantics of fgets should note the
> - difference in how EOF is returned.
> + People used to the 'C' semantics of <function>fgets</function>
> + should note the difference in how <literal>EOF</literal> is returned.
> </simpara>
> <simpara>
> The file pointer must be valid, and must point to a file
> @@ -581,6 +581,12 @@
> <function>popen</function>, or
> <function>fsockopen</function>.
> </simpara>
> + <note>
> + <para>
> + The <parameter>length</parameter> parameter is only optional in
> + PHP 4.1.0 and newer versions.
> + </para>
> + </note>
> <para>
> A simple example follows:
> <example>