svn: phpdoc/en/trunk/reference/outcontrol/functions/ flush.xml
| From: | Rasmus Lerdorf | Date: | Sat, 18 Jul 2009 00:04:18 +0000 |
| Subject: | svn: phpdoc/en/trunk/reference/outcontrol/functions/ flush.xml | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-4476@lists.php.net to get a copy of this message | ||
rasmus Sat, 18 Jul 2009 00:04:18 +0000
URL: http://svn.php.net/viewvc?view=revision&revision=284289
http://bugs.php.net/48933
Changed paths:
U phpdoc/en/trunk/reference/outcontrol/functions/flush.xml
Log:
Clarify flush() docs and close bug#48933
Modified: phpdoc/en/trunk/reference/outcontrol/functions/flush.xml
===================================================================
--- phpdoc/en/trunk/reference/outcontrol/functions/flush.xml 2009-07-17 23:58:14 UTC (rev 284288)
+++ phpdoc/en/trunk/reference/outcontrol/functions/flush.xml 2009-07-18 00:04:18 UTC (rev 284289)
@@ -14,15 +14,16 @@
</methodsynopsis>
<para>
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.
+ a web server, etc). This attempts to push current output all the way to
+ the browser with a few caveats.
</para>
<para>
- <function>flush</function> has no effect on the buffering scheme of your
- 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.
+ <function>flush</function> may not be able to override the buffering scheme
+ of your web server and it has no effect on any client-side buffering in the
+ browser. 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 if you are using
+ those.
</para>
<para>
Several servers, especially on Win32, will still buffer the output from