Add javadoc and simplify point value facade functions that I added
previously. Also they will now obey 'useCache'