Comment From: markpollack

Updated ref docs and class level javadoc.

Merged in d3d34c92158afd2d6775c50e4b83f1266e15a76f