Added JavaDoc for methods.

Added in Javadoc comments for all the methods in the interface.  
@SterL  @JamieWohletz  @ankenmanp  @moquin101 @Kimmsudenver @ericvangelder