add comments for javadoc