fix output buffering levels
Clean up a few doc blocks.