title: JSDoc: How do I document the "options" object literal for a parent "class"?
body: <p>I am using jQuery's <code>$.widget()</code> base "class" which provides an <code>option()</code> method. Since the method is not in my code, I don't have a place to document the argument.</p>
  
  <p>I tried to put jsDoc on the fields in the default options literal, but they're simply not picked up. Then I tried to use the <code>@class</code> and <code>@lends</code> tags on the same object literal, but this may be quite confusing as the object literal is not really a class.</p>
  
  <p>Another alternative I've experimented is to put something like <code>@param options.field description</code> in the constructor's jsDoc. However, this has the disadvantage of separating the documentation from the code. Also, the constructor don't actually have an argument called <code>options</code> as it's all handled by jQuery.</p>
  
  <p>How does you Javascript gurus handle this? Should a new tag be proposed?</p>