clarify buffer docs