added some javadoc documentation