#48933 [NEW]: contradiction in flush() description

From: stepheneliotdewey at gmail dot com Operating system: N/A PHP version: Irrelevant PHP Bug Type: Documentation problem Bug description: contradiction in flush() description Description: ------------ The flush() description starts with the following: "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. flush() has no effect on the buffering scheme of your web server nor the browser on the client side." So, paragraph 1 says that flush() flushes the write buffers of a web server, but paragraph 2 days that it has no effect on a web server's buffering scheme. It is unclear from this description what impact flush() has on a web server's buffering, if any. The following paragraphs describe several server-based restrictions, so perhaps the 1st paragraph should be corrected as follows: "Flushes the write buffers of PHP and tries to flush the write buffers of whatever backend PHP is using (CGI, a web server, etc)..." Reproduce code: --------------- N/A Expected result: ---------------- N/A Actual result: -------------- N/A -- Edit bug report at http://bugs.php.net/?id=48933&edit=1 -- Try a CVS snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=48933&r=trysnapshot52 Try a CVS snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=48933&r=trysnapshot53 Try a CVS snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=48933&r=trysnapshot60 Fixed in CVS: http://bugs.php.net/fix.php?id=48933&r=fixedcvs Fixed in CVS and need be documented: http://bugs.php.net/fix.php?id=48933&r=needdocs Fixed in release: http://bugs.php.net/fix.php?id=48933&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=48933&r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=48933&r=needscript Try newer version: http://bugs.php.net/fix.php?id=48933&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=48933&r=support Expected behavior: http://bugs.php.net/fix.php?id=48933&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=48933&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=48933&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=48933&r=globals PHP 4 support discontinued: http://bugs.php.net/fix.php?id=48933&r=php4 Daylight Savings: http://bugs.php.net/fix.php?id=48933&r=dst IIS Stability: http://bugs.php.net/fix.php?id=48933&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=48933&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=48933&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=48933&r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=48933&r=mysqlcfg