LPS-31950 more javadocs reviewed by Jim