cleanup, docs

site/doc/pages/ob_start.txt

@@ -2,15 +2,19 @@
 void ob_start()
 
 :params
-(none)
+return value : none
+
+:content
+Starts a new output buffer. Subsequent `print()` output is captured into it instead of the response until you collect it with `ob_get_close()` (or discard it with `ob_close()`). Buffers nest: each `ob_start()` pushes another buffer onto the stack. Use it to render a fragment, post-process it, then emit the result.
+
+:example
+ob_start();
+print("buffered text");
+String captured = ob_get_close();
+print("captured: ", captured, "\n");
 
 :see
 >ob
-
-:content
-Starts a new output buffer.
-
-All subsequent output is directed into that buffer until it is closed or collected. Every call to `ob_start()` pushes another buffer onto the output buffer stack. `ob_close()` and `ob_get_close()` destroy buffers and remove them from the stack.
-
-:example
-print("ob_start example\n");
+ob_get_close
+ob_get
+ob_close