completed javadoc