some javadocs for you