updated javadoc in case it doesn't happen tomorrow