completed javadocs