added javadoc comment changes mentioned in the pull request TRUNK-4293