Added some JavaDOC to the compareTo() function.