completed javadoc for methods