Add descriptions on variables in the structs in block_chunkcache.h such as "valid.

Update description of __chunkcache_get to reflect the current code, make it more user friendly as well.

Remove any outdated comments.