A complete Javadoc is necessary here, especially on such an important class. With ```@version``` (1.5.0) and ```@author``` for posterity...