updated javadoc further