Re: [PHP-DOC] cvs: phpdoc /en/reference/filesystem/functionsfile-get-contents.xml

[Philip Olson]

On Mon, 6 Jan 2003, CHAILLAN Nicolas wrote:
> nicos         Mon Jan  6 18:42:52 2003 EDT
> 
>   Modified files:              
>     /phpdoc/en/reference/filesystem/functions file-get-contents.xml 
>   Log:
>   fixing #21460
>   
> Index: phpdoc/en/reference/filesystem/functions/file-get-contents.xml
> diff -u phpdoc/en/reference/filesystem/functions/file-get-contents.xml:1.4 
>phpdoc/en/reference/filesystem/functions/file-get-contents.xml:1.5
> --- phpdoc/en/reference/filesystem/functions/file-get-contents.xml:1.4        Thu 
>Jul 11 17:00:35 2002
> +++ phpdoc/en/reference/filesystem/functions/file-get-contents.xml    Mon Jan  6 
>18:42:51 2003
> @@ -1,5 +1,5 @@
>  <?xml version="1.0" encoding="iso-8859-1"?>
> -<!-- $Revision: 1.4 $ -->
> +<!-- $Revision: 1.5 $ -->
>  <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.130 -->
>    <refentry id="function.file-get-contents">
>     <refnamediv>
> @@ -14,8 +14,9 @@
>        <methodparam 
>choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam>
>       </methodsynopsis>
>      <para> 
> -     Identical to <function>readfile</function>, except that
> -     <function>file_get_contents</function> returns the file in a string.
> +     Identical to <function>file</function>, except that
> +     <function>file_get_contents</function> returns the file in a string 
> +     and not an array where each element corresponds to a line in the file.
>      </para>
>      &note.bin-safe;
>      &tip.fopen-wrapper;

This is confusing, do strings contain elements?  Are the newlines
preserved?  That bug suggests this less confusing version:

  Identical to file(), except that file_get_contents() returns 
  the file in a string.

KISS.

Regards,
Philip



-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php