- 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

@@ -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>

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>

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

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>,