clarify documentation on cache()
Merge pull request #574 from samuelgruetter/cache-documentation

clarify documentation on cache()