[John]

If you use the

/**

*/

comments, the first line is used by the java docs as the general description, @return and @param are used by the java docs to include the return and parameters of methods.