2.2 page cache javadoc improvements

Could this be made into a link? It'll make refactoring safer in the future, since the IDE would make the documentation follow the code, or at least warn when it is out of sync. It also gives me the ability to click to get to that other flag, and I like that, because I'm lazy.