re-updated javadocs