diff --git a/reference/outcontrol/functions/flush.xml b/reference/outcontrol/functions/flush.xml
index d1efa23c05..78a27f6b92 100644
--- a/reference/outcontrol/functions/flush.xml
+++ b/reference/outcontrol/functions/flush.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.flush">
  <refnamediv>
   <refname>flush</refname>
@@ -13,15 +13,16 @@
    <void/>
   </methodsynopsis>
   <para>
-   Flushes the output buffers of PHP and whatever backend PHP is using (CGI,
+   Flushes the write buffers of PHP and whatever backend PHP is using (CGI,
    a web server, etc).  This effectively tries to push all the output so far
    to the user's browser.
   </para>
   <para>
    <function>flush</function> has no effect on the buffering scheme of your
-   web server or the browser on the client side.
-   Thus you need to call both <function>ob_flush</function> and
-   <function>flush</function> to flush the output buffers.
+   web server nor the browser on the client side.  And it also doesn't affect
+   PHP's userspace output buffering mechanism.  This means you will have to
+   call both <function>ob_flush</function> and <function>flush</function> to
+   flush the ob output buffers.
   </para>
   <para>
    Several servers, especially on Win32, will still buffer the output from