[PATCH] comment wl_buffer function

[Marek Ch]

While writing the tests I also added doc comments, but forget to
commit it.
Maybe it will be useful for somebody who will be trying to read
the code later.