如何注释枚举以使 checkstyle 满意？

Question

这是代码：

/**
 * some text.
 */
public class Foo {
  /**
   * Some comment...
   */
  public enum Bar {
    /**
     * some text.
     */
    ABC,
    /**
     * some text.
     */
    CDE;
  };
}

Checkstyle 两次显示 Missing a Javadoc comment.（与 ABC 行和与 CDE 行）。这是关于什么的？我应该在哪里添加评论？ JavaDoc 工作得很好。

Answer 1

神奇的static解决了这个问题：

/**
 * some text.
 */
public class Foo {
  /**
   * Some comment...
   */
  public static enum Bar {
    /**
     ...

Answer 2

注释以 /* 开头，Javadoc 以 /** 开头。如果您使用后者，checkstyle 将警告您缺少一些 Javadoc 详细信息。如果您只想发表评论，请在评论开头使用 /*。

/*
 * some text.
 */
public class Foo {
  /*
   * Some comment...
   */
  public enum Bar {
    /*
     * some text.
     */
    ABC,
    /*
     * some text.
     */
    CDE
  }
}

Answer 3

（将我的评论复制到答案中，因为这似乎是当前的解决方案，并且希望有助于将这个问题标记为关闭）

这可能是 checkstyle 中的错误。错误消息要么不正确（因为 javadoc 工作得很好），要么不清楚（比如注释是否缺少 @author 或其他内容）。