more updates to javadocs