adding rest of the javadoc