Document the buffer transform property

The buffer transform is a pretty confusing thing, so document it in
order to avoid misleading people.