javadoc polishing
minor fixes