new javadocs