From d6b4fef6bf4019db5b7f7c7082c3cbf241d8d095 Mon Sep 17 00:00:00 2001
From: Karoly Negyesi <chx@php.net>
Date: Sun, 12 Jun 2011 07:06:02 +0000
Subject: [PATCH] We really needs warnings based on
 http://bugs.php.net/bug.php?id=40047

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@312085 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/stream/streamwrapper/stream-eof.xml  | 11 +++++++++++
 reference/stream/streamwrapper/stream-read.xml |  7 +++++++
 2 files changed, 18 insertions(+)

diff --git a/reference/stream/streamwrapper/stream-eof.xml b/reference/stream/streamwrapper/stream-eof.xml
index 1f7004f547..3d7fb08de7 100644
--- a/reference/stream/streamwrapper/stream-eof.xml
+++ b/reference/stream/streamwrapper/stream-eof.xml
@@ -54,6 +54,17 @@
  </refsect1>
 -->
 
+ <refsect1 role="notes"><!-- {{{ -->
+  &reftitle.notes;
+  <warning>
+    <para>
+      As long as <methodname>streamWrapper::stream_read</methodname> returns
+      a non-empty string the return value of
+      <methodname>streamWrapper::stream_eof</methodname> is ignored.
+    </para>
+  </warning>
+ </refsect1><!-- }}} -->
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
diff --git a/reference/stream/streamwrapper/stream-read.xml b/reference/stream/streamwrapper/stream-read.xml
index fdf9f3d59a..b232c70257 100644
--- a/reference/stream/streamwrapper/stream-read.xml
+++ b/reference/stream/streamwrapper/stream-read.xml
@@ -99,6 +99,13 @@
     <acronym>EOF</acronym> is assumed.
    </para>
   </note>
+  <warning>
+    <para>
+      As long as <methodname>streamWrapper::stream_read</methodname> returns
+      a non-empty string the return value of
+      <methodname>streamWrapper::stream_eof</methodname> is ignored.
+    </para>
+  </warning>
  </refsect1><!-- }}} -->
  
  <refsect1 role="seealso">