Doc #67341 [NEW]: flush() documentation misleading

From: chealer at gmail dot com Operating system: PHP version: Irrelevant Package: Documentation problem Bug Type: Documentation Problem Bug description:flush() documentation misleading Description: ------------ The synopsis for flush() is "flush — Flush the output buffer". The description starts "Flushes the write buffers of PHP and whatever backend PHP is using (CGI, a web server, etc)." This is quite misleading. The documentation latter explains: " It also doesn't affect PHP's userspace output buffering mechanism. This means you will have to call both ob_flush() and flush() to flush the ob output buffers if you are using those. " Therefore, there may be more than a single output buffer. I do not perfectly understand all buffers involved and I'm not sure about the terminology. What is the antonym of "userspace"? Quickly, I'd suggest: flush — Flush system output buffers "Flushes the system write buffer of PHP and, as much as possible, any write buffer of whatever backend PHP is using (CGI, a web server, etc)." --- From manual page: http://www.php.net/function.flush --- -- Edit bug report at https://bugs.php.net/bug.php?id=67341&edit=1 -- Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=67341&r=trysnapshot54 Try a snapshot (PHP 5.5): https://bugs.php.net/fix.php?id=67341&r=trysnapshot55 Try a snapshot (trunk): https://bugs.php.net/fix.php?id=67341&r=trysnapshottrunk Fixed in SVN: https://bugs.php.net/fix.php?id=67341&r=fixed Fixed in release: https://bugs.php.net/fix.php?id=67341&r=alreadyfixed Need backtrace: https://bugs.php.net/fix.php?id=67341&r=needtrace Need Reproduce Script: https://bugs.php.net/fix.php?id=67341&r=needscript Try newer version: https://bugs.php.net/fix.php?id=67341&r=oldversion Not developer issue: https://bugs.php.net/fix.php?id=67341&r=support Expected behavior: https://bugs.php.net/fix.php?id=67341&r=notwrong Not enough info: https://bugs.php.net/fix.php?id=67341&r=notenoughinfo Submitted twice: https://bugs.php.net/fix.php?id=67341&r=submittedtwice register_globals: https://bugs.php.net/fix.php?id=67341&r=globals PHP 4 support discontinued: https://bugs.php.net/fix.php?id=67341&r=php4 Daylight Savings: https://bugs.php.net/fix.php?id=67341&r=dst IIS Stability: https://bugs.php.net/fix.php?id=67341&r=isapi Install GNU Sed: https://bugs.php.net/fix.php?id=67341&r=gnused Floating point limitations: https://bugs.php.net/fix.php?id=67341&r=float No Zend Extensions: https://bugs.php.net/fix.php?id=67341&r=nozend MySQL Configuration Error: https://bugs.php.net/fix.php?id=67341&r=mysqlcfg