better javadocs