doc: revisions to cache.py (2)