Clarify what happens if shallow is false. Also, the caching note is not really correct since the cache gets occasionally cleared; therefore I removed it.
E
Eli Bendersky committed
e431ed23544214a336a556dfa8e080e26d445fd5
Parent: c59cc8f