Comments are great!  Let's write them according to the standard Javadoc way.

In your IDE, if you go on the line above a method signature and type

/**

Then hit return, it'll fill in the rest.  Basically the difference is an extra * on the initial line with no comment and then items for each of the individual arguments and the return value.