adding some javadoc