diff --git a/reference/filesystem/functions/feof.xml b/reference/filesystem/functions/feof.xml
index fb1dbfdcd8..6fddda0054 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.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.feof">
    <refnamediv>
@@ -13,9 +13,18 @@
       <methodparam><type>resource</type><parameter>handle</parameter></methodparam>
      </methodsynopsis>
     <para>
-     Returns &true; if the file pointer is at EOF or an error occurs;
-     otherwise returns &false;.
+     Returns &true; if the file pointer is at EOF or an error occurs
+     (including socket timeout); otherwise returns &false;.
     </para>
+     <warning>
+      <simpara>
+       feof will return &true; only if the connection opened by
+       <function>fsockopen</function> is closed. This can cause a script to
+       timeout. The workaround for this is to use
+       <function>stream_set_timeout</funtion>, so that feof will return &false;
+       on timeout.
+      </simpara>
+     </warning>
     <para>
      The file pointer must be valid, and must point to a file
      successfully opened by <function>fopen</function>,