diff --git a/appendices/migration5.xml b/appendices/migration5.xml
index f1730467fe..d6f61267f6 100755
--- a/appendices/migration5.xml
+++ b/appendices/migration5.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.24 $ -->
+<!-- $Revision: 1.25 $ -->
  <appendix id="migration5">
   <title>Migrating from PHP 4 to PHP 5</title>
 
@@ -102,11 +102,18 @@
     </listitem>
     <listitem>
      <simpara>
-      <function>ip2long</function> now returns FALSE when an invalid IP
+      <function>ip2long</function> now returns &false; when an invalid IP
       address is passed as argument to the function, and no longer
       <literal>-1</literal>.
      </simpara>
     </listitem>
+    <listitem>
+     <simpara>
+      <function>include_once</function> and <function>require_once</function>
+      first normalize the path of included file on Windows so that including
+      A.php and a.php include the file just once.
+     </simpara>
+    </listitem>
    </itemizedlist>
 
    <para>
diff --git a/language/control-structures.xml b/language/control-structures.xml
index 099ed99485..b3d9bce0ec 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.94 $ -->
+<!-- $Revision: 1.95 $ -->
  <chapter id="language.control-structures">
   <title>Control Structures</title>
 
@@ -1526,11 +1526,14 @@ echo $bar; // prints 1
 <![CDATA[
 <?php
 require_once("a.php"); // this will include a.php
-require_once("A.php"); // this will include a.php again on Windows!
+require_once("A.php"); // this will include a.php again on Windows! (PHP 4 only)
 ?>
 ]]>
         </programlisting>
       </example>
+      This behaviour changed in PHP 5 - the path is normalized first so that
+      <filename>C:\PROGRA~1\A.php</filename> is realized the same as
+      <filename>C:\Program Files\a.php</filename> and the file is required just once.
      </para>
     </note>
    </para>
@@ -1586,11 +1589,14 @@ require_once("A.php"); // this will include a.php again on Windows!
 <![CDATA[
 <?php
 include_once("a.php"); // this will include a.php
-include_once("A.php"); // this will include a.php again on Windows!
+include_once("A.php"); // this will include a.php again on Windows! (PHP 4 only)
 ?>
 ]]>
         </programlisting>
       </example>
+      This behaviour changed in PHP 5 - the path is normalized first so that
+      <filename>C:\PROGRA~1\A.php</filename> is realized the same as
+      <filename>C:\Program Files\a.php</filename> and the file is included just once.
      </para>
     </note>
    </para>