added javadoc note