polishing javadocs