Doc #67341 [Opn->Csd]: flush() documentation misleading

Edit report at https://bugs.php.net/bug.php?id=67341&edit=1 ID: 67341 Updated by: mike@php.net Reported by: chealer at gmail dot com Summary: flush() documentation misleading -Status: Open +Status: Closed Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant -Assigned To: +Assigned To: mike Block user comment: N Private report: N Previous Comments: ------------------------------------------------------------------------ [2014-07-06 00:49:35] yohgaki@php.net Automatic comment from SVN on behalf of yohgaki Revision: http://svn.php.net/viewvc/?view=revision&revision=334135 Log: Fixed bug #67341 ------------------------------------------------------------------------ [2014-05-25 23:55:27] chealer at gmail dot com 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 this bug report at https://bugs.php.net/bug.php?id=67341&edit=1