[buffer] avoid compiler warnings
[buffer] update doc and images
[buffer][doc] small changes in outputted text/comments