From 8be263e2593160592f2a2b363fce018e5a1e846f Mon Sep 17 00:00:00 2001
From: Gabor Hojtsy <goba@php.net>
Date: Mon, 29 Jul 2002 20:57:18 +0000
Subject: [PATCH] Adding case sensitivity note to include_once and require_once

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@90352 c90b9560-bf6c-de11-be94-00142212c4b1
---
 language/control-structures.xml | 34 ++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/language/control-structures.xml b/language/control-structures.xml
index 877774da1e..94c01bcde7 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.59 $ -->
+<!-- $Revision: 1.60 $ -->
  <chapter id="control-structures">
   <title>Control Structures</title>
 
@@ -1357,6 +1357,22 @@ echo $bar; // prints 1
      <function>require_once</function> was added in PHP 4.0.1pl2
     </para>
    </note>
+   <note>
+    <para>
+     Be aware, that the behaviour of <function>require_once</function>
+     amd <function>include_once</function> may not be what you expect
+     on a non case sensitive operating system (such as Windows).
+     <example>
+      <title><function>require_once</function> is case sensitive</title>
+      <programlisting role="php">
+<![CDATA[
+require_once("a.php"); // this will include a.php
+require_once("A.php"); // this will include a.php again on Windows!
+]]>
+       </programlisting>
+     </example>
+    </para>
+   </note>
    &warn.no-win32-fopen-wrapper;
    <para>
     See also: <function>require</function>,
@@ -1395,6 +1411,22 @@ echo $bar; // prints 1
      <function>include_once</function> was added in PHP 4.0.1pl2
     </para>
    </note>
+   <note>
+    <para>
+     Be aware, that the behaviour of <function>include_once</function>
+     amd <function>require_once</function> may not be what you expect
+     on a non case sensitive operating system (such as Windows).
+     <example>
+      <title><function>include_once</function> is case sensitive</title>
+      <programlisting role="php">
+<![CDATA[
+include_once("a.php"); // this will include a.php
+include_once("A.php"); // this will include a.php again on Windows!
+]]>
+       </programlisting>
+     </example>
+    </para>
+   </note>
    &warn.no-win32-fopen-wrapper;
    <para>
     See also <function>include</function>,