adding some javadocs