amended javadocs