Added javadoc markup to caching classes - references issue #1