diff --git a/functions/dir.xml b/functions/dir.xml
index 83734f5412..5f91af70c9 100644
--- a/functions/dir.xml
+++ b/functions/dir.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.26 $ -->
+<!-- $Revision: 1.27 $ -->
  <reference id="ref.dir">
   <title>Directory functions</title>
   <titleabbrev>Directories</titleabbrev>
@@ -102,6 +102,12 @@ $d->close();
       </programlisting>
      </example>
     </para>
+    <note>
+     <para>
+      The order in which directory entries are returned by the read method is
+      system-dependent.
+     </para>
+    </note>
    </refsect1>
   </refentry>