Update javadoc to provide more info on the cache behaviour.