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.
-
+