* add documentation for decode_only_header, decode_with_offset, decode_only_header_with_offset and decode_with_header_and_offset
* fix documentation of bytes_consumed