updated javadocs to reflect new design