Epic Fail: JavaDoc

/**
 * This is a Java class. It contains one or more
 * methods that perform certain functions.
 */
class Foo {
  /**
   * A function that takes two parameters and
   * calculates the result depending on these
   * parameters.
   *
   * @param a The first parameter, a String.
   * @param b The second parameter, an integer.
   * @returns the result (as double), depending
   *   on the input parameters.
   * @throws Exception if an exception occurred.
   */
  public double calculateResult(String a, int b)
      throws Exception {
    return ((double) (a.length()*b)) / 3.4;
  }

  /**
   * This is an inner class that contains two
   * public variables.
   */
  class InnerClass {
    /**
     * A public String variable named x.
     */
    public String x;

    /**
     * A public string variable named y.
     */
    public String y;
  }
}