clarify documentation on cache()

I lost some time because I didn't read the documentation of `cache()` carefully enough. To make it easier for others, I tried to make the documentation more explicit here.