Misc buffer fixes and documentation improvements from PR 1361.

Either it "Allocates and sets up" the buffer, or we can use the imperative "Allocate and setup"; mixing the two, as here, is ungrammatical.