From 45b1f93b7a4d1cb50cbd67e6a62def0560989980 Mon Sep 17 00:00:00 2001
From: anatoly techtonik <techtonik@php.net>
Date: Tue, 20 Sep 2005 12:06:16 +0000
Subject: [PATCH] + document feof() pitfall if invalid handle passed

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@196438 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/filesystem/functions/feof.xml | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/reference/filesystem/functions/feof.xml b/reference/filesystem/functions/feof.xml
index 1c81fad206..21e047113c 100644
--- a/reference/filesystem/functions/feof.xml
+++ b/reference/filesystem/functions/feof.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.feof">
    <refnamediv>
@@ -26,6 +26,26 @@
       </simpara>
      </warning>
      &fs.validfp.all;
+     <warning>
+       If passed file pointer is not valid you may get an infinite loop, because
+       EOF fails to return TRUE.
+       <example>
+        <programlisting role="php">
+ <![CDATA[
+<?php
+// if file can not be read or doesn't exist fopen function returns FALSE
+$file = @fopen("no_such_file", "r");
+
+// FALSE from fopen will issue warning and result in infinite loop here
+while (!feof($file)) {
+}
+
+fclose($file);
+?>
+?]]>
+        </programlisting>
+       </example>
+     </warning>
    </refsect1>
   </refentry>