improve javadoc comments