title: Should I use JavaDoc deprecation or the annotation in Java?
body: <p>There are at the moment, two ways to mark code as depreacted in java.</p>
  
  <p>Via JavaDoc</p>
  
  <pre><code>/**
   * @deprecated
   */
  </code></pre>
  
  <p>Or as an annotation:</p>
  
  <pre><code>@Deprecated
  </code></pre>
  
  <p>This is my problem - I find it a bit too much to declare both, when marking a method as deprecated when using Eclipse. I really just want to use one of them.</p>
  
  <p>However does using the annotation give the compiler actual useful additional information?</p>
  
  <p>But only using the annotation, I cannot state why the method is deprecated - I can only do that with JavaDoc, and deprecating a method without specying why is bad.</p>
  
  <p>So, can I only use one of them? Or should I really just learn to specify both?</p>