some javadocs