updated javadoc documentation