Updating and clarifying javadocs.