updating the javadoc in the interface and the function prototype