doc: revisions to cache.py