updated javadoc definitions