fix #30734: unread_bytes shouldnt be used

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@172514 c90b9560-bf6c-de11-be94-00142212c4b1

reference/stream/functions/stream-get-meta-data.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
   <refentry id="function.stream-get-meta-data">
    <refnamediv>
     <refname>stream_get_meta_data</refname>
@@ -43,8 +43,13 @@
      <listitem>
       <para>
        <parameter>unread_bytes</parameter> (int) - the number of bytes
-       currently contained in the read buffer.
+       currently contained in the PHP's own internal buffer.
       </para>
+      <note>
+       <simpara>
+        You shouldn't use this value in a script.
+       </simpara>
+      </note>
      </listitem>
     </itemizedlist>
     <simpara>