Add note about caching.
Re-wording of some comments. No practical changes.
Bump version number to reflect change in functionality.