cache doc

I don't know if this is a "defect" or a "feature" of cache's eager mechanism. Either way, playing with it, I was able to observe a few interesting details, which I thought were subtle enough to warrant documentation.