title: What is the best way to use JavaDoc to document a Java enum?
body: <p>I've just started using Java's enums in my own projects (I have to use JDK 1.4 at work) and I am confused as to the best practice of using JavaDoc for an enum.</p>
  
  <p>I have found that this method works, but the resultant code is a little unrefined:</p>
  
  <pre><code>/**
  * Doc for enum
  */
  public enum Something {
  /**
  * First thing
  */
  FIRST_THING,
  /**
  * Second thing
  */
  SECOND_THING;
  //could continue with more
  }
  </code></pre>
  
  <p>Is there any way I could break up the enum declarations on their own lines without chaining them by commas, or is this the best approach for using JavaDoc for an enum?</p>