LPS-29503 Javadocs reviewed by Jim