javadoc for each new method which was added