title: Details of difference between @see and @inheritDoc
body: <p>I have looked over <a href="http://docs.oracle.com/javase/6/docs/technotes/tools/solaris/javadoc.html">JavaDoc reference</a>, and while I understand basic difference between <code>@see</code> (various links) and <code>{@inheritDoc}</code> (export of superclass JavaDoc comment), I need clarification on how things actually implemented.</p>
  
  <p>In Eclipse IDE when I select “Generate Element Comments” for the inherited method (from interface, or toString() override, and so forth) it creates following comment</p>
  
  <pre><code>/* (non-Javadoc)
   * @see SomeClass#someMethod()
   */
  </code></pre>
  
  <p>If I am required to produce JavaDoc should I leave it at that, replace <code>@see</code> with <code>{@inheritDoc}</code>, or turn it in <em>bona fide</em> JavaDoc as such:</p>
  
  <pre><code>/**
   * {@inheritDoc}
   */
  </code></pre>
  
  <p>And when I do that, should I still keep the class#method flag?</p>