java - checkstyleを幸せにするために列挙型にコメントする方法は？

Question

これはコードです：

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

CheckstyleはMissing a Javadoc comment.2回言います（ linewithABCとlinewith CDE）。どんな内容ですか？コメントはどこに追加すればよいですか？JavaDocは問題なく動作します。

Answer 1

マジックスタティックは問題を解決します：

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

Answer 2

（私のコメントを回答にコピーします。これが現在の解決策のようであり、この質問をクローズするのに役立つことを願っています）

これはcheckstyleのバグである可能性があります。エラーメッセージが正しくない（javadocが正常に機能するため）か、不明確です（コメントに@authorなどがない場合など）。

Answer 3

コメントは/ *で始まり、Javadocは/**で始まります。後者を使用する場合、checkstyleはJavadocの詳細の一部が欠落していることを警告します。コメントだけにする場合は、コメントの先頭に/*を使用します。

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