added some docs to codec interface