cleanup, formatting conditionals for readability
better docs for CacheObj