updates to javadocs