title: Is it possible to tell jsdoc to look in a file separate from the source code for documentation of that code?
body: <p>I would like to keep inline comments as short as possible, since my experience is that comments of more than 3 or 4 lines tend to be glossed over, creating a lot of unnecessary "read the manual lines".</p>
  
  <p>I'm required by legacy to adhere to a jsdoc-compatible format for documenting code.  It requires that a lot of self evident things be declared explicitly if they're to be documented correctly.  Practically every tag can fall in this category.  Even the ones that don't are often useless to a working developer.</p>
  
  <p>My vision is to have a quick summary inside the code itself that developers will actually read, but refer to a separate file (or even a comment dump in the same file, separate from where developers will be working) for additional tagging, like this:</p>
  
  <pre><code>/**
   *  Used when making an example of the argument.
   *  @include someotherplace
   */
  function example(argument) { stuff;}
  
  ...lots more code...
  
  /**
   *  someotherplace
   *  @param argument The victim
   *  @since forever
   *  @other stuff
   */
  </code></pre>
  
  <p>A different tool or a plugin would be acceptable, I'm really only stuck with the syntax.  Another alternative would be a tool with some really good implicit documentation creation</p>