cleanup, docs

site/doc/pages/ob_get_close.txt

@@ -2,15 +2,20 @@
 String ob_get_close()
 
 :params
-return value : content of the current output buffer
+return value : the current buffer's contents
+
+:content
+Returns the current output buffer's contents and discards the buffer, switching back to the previous one on the stack. This is the usual way to capture rendered output for post-processing.
+
+:example
+ob_start();
+print("hello ");
+print("world");
+String html = ob_get_close();
+print("captured ", html.length(), " chars: ", html, "\n");
 
 :see
 >ob
-
-:content
-Returns the contents of the current output buffer and then discards that buffer.
-
-If more output buffers remain on the stack, UCE switches to the next one.
-
-:example
-print("ob_get_close example\n");
+ob_start
+ob_get
+ob_close