diff --git a/reference/outcontrol/functions/ob-get-status.xml b/reference/outcontrol/functions/ob-get-status.xml index 20b8ab88b937..687002bcc47f 100644 --- a/reference/outcontrol/functions/ob-get-status.xml +++ b/reference/outcontrol/functions/ob-get-status.xml @@ -107,7 +107,14 @@ buffer_size - Output buffer size in bytes + Currently allocated size of the output buffer in bytes. + It starts at 16384 bytes with the default + chunk_size, or at + chunk_size rounded up to the next multiple of + 4096 when one is given, and grows in multiples of + 4096 as more output is buffered. + This is not the amount of data in the buffer (see + buffer_used). diff --git a/reference/outcontrol/functions/ob-start.xml b/reference/outcontrol/functions/ob-start.xml index 1239b0cc0b58..d50a84aca340 100644 --- a/reference/outcontrol/functions/ob-start.xml +++ b/reference/outcontrol/functions/ob-start.xml @@ -111,15 +111,22 @@ chunk_size - + If the optional parameter chunk_size is passed, the buffer will be flushed after any block of code resulting in output that causes the buffer's length to equal or exceed chunk_size. The default value 0 means that all output is buffered until the buffer is turned off. + A value of 1 means the buffer will be flushed + after every output operation, effectively disabling buffering. + chunk_size also determines the initial size of + the buffer reported by ob_get_status: + 16384 bytes when it is 0, and + chunk_size rounded up to the next multiple of + 4096 otherwise. See for more details. - +