adding a javadoc note