Rewrote some JavaDoc due to appallingness of the English used previously.