document full-and-empty state for the buffer
more docs