add comment to pkg doc for "decoded" variable