From a923054db92044adcebad32bb8706905185a8191 Mon Sep 17 00:00:00 2001
From: Sara Golemon <pollita@php.net>
Date: Thu, 24 Apr 2003 23:47:12 +0000
Subject: [PATCH] Show defaults for context options, clear up documentation on
 opening ftp:// URLs for writting, and add note for appending.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@124528 c90b9560-bf6c-de11-be94-00142212c4b1
---
 appendices/wrappers.xml | 27 +++++++++++++++++++++------
 1 file changed, 21 insertions(+), 6 deletions(-)

diff --git a/appendices/wrappers.xml b/appendices/wrappers.xml
index 23c9a174de..b2f8b42045 100644
--- a/appendices/wrappers.xml
+++ b/appendices/wrappers.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.13 $ -->
+<!-- $Revision: 1.14 $ -->
 <appendix id="wrappers">
  <title>List of Supported Protocols/Wrappers</title>
  <para>
@@ -58,14 +58,15 @@
       <row>
        <entry>Name</entry>
        <entry>Usage</entry>
+       <entry>Default</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry><literal>method</literal></entry>
        <entry><constant>GET</constant> or <constant>POST</constant>
-        (defaults to <constant>GET</constant>).
        </entry>
+       <entry><constant>GET</constant></entry>
       </row>
       <row>
        <entry><literal>header</literal></entry>
@@ -74,6 +75,7 @@
         <literal>User-agent:</literal>, <literal>Host:</literal>,
         and <literal>Authentication:</literal>.
        </entry>
+       <entry></entry>
       </row>
       <row>
        <entry><literal>content</literal></entry>
@@ -81,6 +83,7 @@
         Additional data to be sent after the headers.  Typically used
         with POST requests.
        </entry>
+       <entry></entry>
       </row>
      </tbody>
     </tgroup>
@@ -107,10 +110,21 @@
   <simpara>
    You can open files for either reading or writing, but not both
    simultaneously.  If the remote file already exists on the ftp
-   server and you attempt to open it for writing, the connection
-   will fail.  If you need to update existing files over ftp,
-   use <function>ftp_connect</function>.
+   server and you attempt to open it for writing but have not specified
+   the context option <literal>overwrite</literal>, the connection
+   will fail.  If you need to overwrite existing files over ftp,
+   specify the <literal>overwrite</literal> option in the context 
+   and open the file for writting.  Alternatively, you can
+   use the <link linkend="ref.ftp">FTP extension</link>.
   </simpara>
+  <note>
+   <title>Appending</title>
+   <simpara>
+    As of <literal>PHP 5.0</literal> files may be appended via the
+    <literal>ftp://</literal> url wrapper.  In prior versions, attempting
+    to append to a file via <literal>ftp://</literal> will result in failure.
+   </simpara>
+  </note>
   <simpara>
    <filename>ftps://</filename> was introduced in PHP 4.3.  
    It is the same as <filename>ftp://</filename>,
@@ -131,6 +145,7 @@
       <row>
        <entry>Name</entry>
        <entry>Usage</entry>
+       <entry>Default</entry>
       </row>
      </thead>
      <tbody>
@@ -138,8 +153,8 @@
        <entry><literal>overwrite</literal></entry>
        <entry>
         Allow overwritting of already existing files on remote server.
-        Disabled by default.
        </entry>
+       <entry>&false; (Disabled)</entry>
       </row>
      </tbody>
     </tgroup>