Misc buffer fixes and documentation improvements from PR 1361.

s/the its/its/ ... and, frankly, "structure" is implicit in "buffer" so not worth saying; you didn't for the constructor.