add rdoc/yard documentation

mark buffer_clear_pending private since it should be.
don't re-raise errors

this was used for debugging specs
buffer_clear_pending was moved incorrectly

should be part of Stud::Buffer, not Stud.