Patch against flush()

Hi All, I've had this bug assigned forever, and have finally gotten around to trying a fix. I believe I have karma, but I've been out of the game long enough that I wanted to run it by others before committing. Any suggestions on how to improve the below? --- en/reference/outcontrol/functions/flush.xml +++ en/reference/outcontrol/functions/flush.xml @@ -47,15 +47,24 @@ send extra whitespace before flushing to get those browsers to display the page. </para> + <warning> + <para> + Calling <function>flush</function> while an output handler such as ob_start('ob_gzhandler'); + is set will result in the buffer being sent immediately, + terminating the previously set handler. So while normally ob_start('ob_gzhandler'); + would compress ouput, calling <function>flush</function> would terminate that, and send uncompressed + output. + </para> + </warning> </refsect1> - + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.void; </para> </refsect1> - + <refsect1 role="seealso"> &reftitle.seealso; <para> @@ -67,7 +76,7 @@ </simplelist> </para> </refsect1> - + </refentry> <!-- Keep this comment at the end of the file -- Paul Reinheimer