title: How to document return in JavaScript
body: <p>I'm writing my own library for the project at work for a browser application and I am having the same old problem deciding how to comment the code.</p>
  
  <p>I'm trying to follow the <a href="https://code.google.com/p/jsdoc-toolkit/w/list">JsDoc</a> syntax, but will probably continue the <a href="https://developers.google.com/closure/compiler/docs/js-for-compiler">Google Closure Compiler</a> way. I may end up using two @return and @returns tags in the documentation, just for portability sake (when I setup the auto-generation of the documentation).</p>
  
  <p>Now, the question, <strong>how do you document the return of a custom anonymous object from a function?</strong> For example:</p>
  
  <pre><code>return {
      username: 'username',
      password: 'password',
      enabled:  true
  };
  </code></pre>
  
  <p>JsDoc has an example of how a @param can be documented to expect object with certain fields, but not the @returns tag. Similarly, the Google Closure Compiler documentation of a Record Type is vague and has no example to work it out.</p>