javadocs polishing