From d04f1309c8d93d2c7447b37eb6dfbaaf4ba0669b Mon Sep 17 00:00:00 2001
From: Markus Fischer <mfischer@php.net>
Date: Mon, 10 Jun 2002 21:41:16 +0000
Subject: [PATCH] - Add appropriate warnings that Windows does not support
 remote file access   for the include/require friends.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@85326 c90b9560-bf6c-de11-be94-00142212c4b1
---
 chapters/config.xml             | 10 +++++++++-
 features/remote-files.xml       |  8 +++++---
 language-snippets.ent           |  6 ++++++
 language/control-structures.xml |  6 +++++-
 4 files changed, 25 insertions(+), 5 deletions(-)

diff --git a/chapters/config.xml b/chapters/config.xml
index 4ac45eb635..38c44a9018 100644
--- a/chapters/config.xml
+++ b/chapters/config.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.56 $ -->
+<!-- $Revision: 1.57 $ -->
  <chapter id="configuration">
   <title>Configuration</title>
 
@@ -169,6 +169,14 @@ linkend="install.configure.disable-url-fopen-wrapper"><parameter>--d
 isable-url-fopen-wrapper</parameter></link>.
          </para>
         </note>
+        <warning>
+         <para> 
+          On Windows, the following functions do not support remote file
+          accesing: <function>include</function>,
+          <function>include_once</function>, <function>require</function> and
+          <function>require_once</function>.
+         </para>
+        </warning>
 
        </listitem>
       </varlistentry>
diff --git a/features/remote-files.xml b/features/remote-files.xml
index b1be14555b..f1e55df330 100644
--- a/features/remote-files.xml
+++ b/features/remote-files.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.16 $ -->
+<!-- $Revision: 1.17 $ -->
  <chapter id="features.remote-files">
   <title>Using remote files</title>
 
@@ -16,8 +16,10 @@
   <para>
    <note>
     <para>
-     You can't use remote files in <function>include</function> and
-     <function>require</function> statements on Windows.
+     The Windows version of <literal>PHP</literal> currently does not support
+     remote file accessing for the following functions:
+     <function>include</function>, <function>include_once</function>,
+     <function>require</function> and <function>require_once</function>.
     </para>
    </note>
   </para>
diff --git a/language-snippets.ent b/language-snippets.ent
index ebea4ac7d2..a336dba3f2 100644
--- a/language-snippets.ent
+++ b/language-snippets.ent
@@ -17,6 +17,12 @@ warned and use this function at your own risk.</simpara></warning>'>
 currently not documented; only the argument list is
 available.</simpara></warning>'>
 
+<!ENTITY warn.no-win32-fopen-wrapper '<warning><para>The Windows
+version of <literal>PHP</literal> currently does not support remote
+file accessing for this function, even if
+<link linkend="ini.allow-url-fopen">allow_url_fopen</link> is enabled.
+</para></warning>'>
+
 <!ENTITY tip.ob-capture '<tip><simpara>As with anything that outputs
 its result directly to the browser, you can use the <link
 linkend="ref.outcontrol">output-control functions</link> to capture
diff --git a/language/control-structures.xml b/language/control-structures.xml
index b937cc63e1..877774da1e 100644
--- a/language/control-structures.xml
+++ b/language/control-structures.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.58 $ -->
+<!-- $Revision: 1.59 $ -->
  <chapter id="control-structures">
   <title>Control Structures</title>
 
@@ -1077,6 +1077,7 @@ require ('somefile.txt');
      <function>require</function> itself happens only once.
     </simpara>
    </note>
+   &warn.no-win32-fopen-wrapper;
    <simpara>
     See also <function>include</function>, <function>require_once</function>,
     <function>include_once</function>, <function>eval</function>, 
@@ -1191,6 +1192,7 @@ echo "A $color $fruit";   // A green
      being run on the remote server and the result is then being
      included into the local script.
    </simpara>
+   &warn.no-win32-fopen-wrapper;
    <para>
     <example>
      <title><function>include</function> through HTTP</title>
@@ -1355,6 +1357,7 @@ echo $bar; // prints 1
      <function>require_once</function> was added in PHP 4.0.1pl2
     </para>
    </note>
+   &warn.no-win32-fopen-wrapper;
    <para>
     See also: <function>require</function>,
     <function>include</function>, <function>include_once</function>,
@@ -1392,6 +1395,7 @@ echo $bar; // prints 1
      <function>include_once</function> was added in PHP 4.0.1pl2
     </para>
    </note>
+   &warn.no-win32-fopen-wrapper;
    <para>
     See also <function>include</function>,
     <function>require</function>, <function>require_once</function>,