more on decode
update documentation