repair the javadoc

adding necessary comment