From 1afdc77d297fdbd890744cfbba53056649c21d7e Mon Sep 17 00:00:00 2001
From: Wez Furlong <wez@php.net>
Date: Sat, 16 Mar 2002 17:02:35 +0000
Subject: [PATCH] More docs for streams related changes.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@73614 c90b9560-bf6c-de11-be94-00142212c4b1
---
 functions/filesystem.xml | 37 ++++++++++++++++++++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

diff --git a/functions/filesystem.xml b/functions/filesystem.xml
index ba122e3c7b..ca15af5daa 100644
--- a/functions/filesystem.xml
+++ b/functions/filesystem.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.129 $ -->
+<!-- $Revision: 1.130 $ -->
  <reference id="ref.filesystem">
   <title>Filesystem functions</title>
   <titleabbrev>Filesystem</titleabbrev>
@@ -233,6 +233,13 @@ if (!copy($file, $file.'.bak')) {
       </programlisting>
      </example>
     </para>
+    <note>
+     <para>
+      As of PHP 4.3.0, both <parameter>source</parameter> and
+      <parameter>dest</parameter> may be URLs if the "fopen wrappers"
+      have been enable.  See <function>fopen</function> for more details.
+     </para>
+    </note>
     <warning>
      <para>
       If the destination file already exists, it will be overwritten.
@@ -672,6 +679,27 @@ fclose ($fd);
    </refsect1>
   </refentry>
 
+  <refentry id="function.file-get-contents">
+   <refnamediv>
+    <refname>file_get_contents</refname> 
+    <refpurpose>Reads entire file into a string</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+     <methodsynopsis>
+      <type>string</type><methodname>file_get_contents</methodname>
+      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
+      <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.
+    </para>
+    &note.bin-safe;
+    &tip.fopen-wrapper;
+   </refsect1>
+  </refentry>
+  
   <refentry id="function.file">
    <refnamediv>
     <refname>file</refname> 
@@ -720,6 +748,12 @@ $fcontents = implode ('', file ('http://www.php.net/'));
       </programlisting>
      </informalexample>
     </para>
+    <note>
+     <para>
+      As of PHP 4.3.0 you can use <function>file_get_contents</function> to
+      return the contents of a file as a string in a binary safe manner.
+     </para>
+    </note>
     &note.not-bin-safe;
     &tip.fopen-wrapper;
     <para> 
@@ -1184,6 +1218,7 @@ $fcontents = implode ('', file ('http://www.php.net/'));
      As of PHP 4.3.0 (not yet released), if you have compiled in
      support for OpenSSL, you may use "https://" to open an HTTP
      connection over SSL.
+    </simpara>
     <simpara>
      Note that the file pointer allows you to retrieve only the
      <emphasis>body</emphasis> of the response; to retrieve the HTTP