From 9d5179e5c3a565b6835bcf01bdb280712c46fcc5 Mon Sep 17 00:00:00 2001
From: Andy Lindeman <alindeman@php.net>
Date: Tue, 26 Feb 2002 21:47:10 +0000
Subject: [PATCH] Fixing bug #15723

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@70993 c90b9560-bf6c-de11-be94-00142212c4b1
---
 functions/dir.xml | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/functions/dir.xml b/functions/dir.xml
index 1cbfee51d1..75b4d4dab0 100644
--- a/functions/dir.xml
+++ b/functions/dir.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.33 $ -->
+<!-- $Revision: 1.34 $ -->
  <reference id="ref.dir">
   <title>Directory functions</title>
   <titleabbrev>Directories</titleabbrev>
@@ -90,6 +90,15 @@
      <function>closedir</function>.  The path property is set to path
      the directory that was opened.  Three methods are available:
      read, rewind and close.
+     </para>
+    <para>
+     Please note the fashion in which <function>dir</function>'s
+     return value is checked in the example below. We are explicitly
+     testing whether the return value is identical to (equal to and of
+     the same type as--see <link linkend="language.operators.comparison">
+     Comparison Operators</link> for more information) &false; since
+     otherwise, any directory entry whose name evaluates to &false; will
+     stop the loop.
      <example>
       <title><function>dir</function> example</title>
       <programlisting role="php">