document cache control. Fixes gh-265