From 707622fbc90e1b9705a60a7dca4b281c4acad994 Mon Sep 17 00:00:00 2001
From: Jakub Vrana <vrana@php.net>
Date: Wed, 21 Nov 2007 15:18:39 +0000
Subject: [PATCH] List reading stop (bug #42827)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@246614 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/filesystem/functions/fread.xml | 35 ++++++++++++++++++------
 1 file changed, 27 insertions(+), 8 deletions(-)

diff --git a/reference/filesystem/functions/fread.xml b/reference/filesystem/functions/fread.xml
index 6df70bc40d..3c703b809e 100644
--- a/reference/filesystem/functions/fread.xml
+++ b/reference/filesystem/functions/fread.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.24 $ -->
+<!-- $Revision: 1.25 $ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fread">
  <refnamediv>
   <refname>fread</refname>
@@ -13,15 +13,34 @@
    <methodparam><type>resource</type><parameter>handle</parameter></methodparam>
    <methodparam><type>int</type><parameter>length</parameter></methodparam>
   </methodsynopsis>
-  <simpara>
+  <para>
    <function>fread</function> reads up to
    <parameter>length</parameter> bytes from the file pointer
-   referenced by <parameter>handle</parameter>. Reading stops when up to
-   <parameter>length</parameter> bytes have been read, EOF
-   (end of file) is reached, (for network streams) when a packet becomes
-   available, or (after opening userspace stream) when 8192 bytes have been read
-   whichever comes first.
-  </simpara>
+   referenced by <parameter>handle</parameter>. Reading stops as soon as one
+   of the following conditions is met:
+   <itemizedlist>
+    <listitem>
+     <simpara>
+      <parameter>length</parameter> bytes have been read
+     </simpara>
+    </listitem>
+    <listitem>
+     <simpara>
+      EOF (end of file) is reached
+     </simpara>
+    </listitem>
+    <listitem>
+     <simpara>
+      a packet becomes available (for network streams)
+     </simpara>
+    </listitem>
+    <listitem>
+     <simpara>
+      8192 bytes have been read (after opening userspace stream)
+     </simpara>
+    </listitem>
+   </itemizedlist>
+  </para>
  </refsect1>
 
  <refsect1 role="parameters">