update docs of get_buffer()