title: Is There Any Way to Avoid Using the JSDoc "@method" Annotation
body: <p>I'm not a big fan of generated documentation personally (I'm more of a "read the source Luke" kinda guy), but I can see how such documentation might be useful to others.  Now, normally their generating of documentation wouldn't impact me, except for one thing: @method.</p>
  
  <p>Most JSDoc annotations (eg. <code>@param</code>) are still perfectly useful to someone reading the source, but <code>@method</code> is 100% redundant:</p>
  
  <pre><code>/*
   * @param num number to add five to
   * @method addFive
   */
  function addFive(num) { ...
  </code></pre>
  
  <p>So, I'd really like to avoid having hundreds of <code>@method</code> lines cluttering up our code.  However, my co-worker believes that <code>@method</code> is necessary for the JSDoc generators (he's using the YUI one) to be able to generate the method lists of classes.</p>
  
  <p>So, my question (to the JSDoc experts out there) is: is there any way to generate useful documentation (ie. with the methods of a class listed) without <code>@method</code>?  Or if <code>@method</code> is truly required, is there any JSDoc generator that can infer the method name from the function name, so that I can get away with <code>@method</code> instead of <code>@method addFive</code>?</p>
  
  <p>P.S. If there's a "you're doing it wrong"-type answer that doesn't directly answer the question but suggests a way of avoiding the problem entirely, I'd love to hear it; I'm certainly no JSDoc expert.</p>