JsDoc

perl製のJSDocと JavaScript実装のJsDoc Toolkitがある。両者微妙に記法が違う。

JsDoc Toolkit TagReference
http://code.google.com/p/jsdoc-toolkit/wiki/TagReference

JSDoc Tag Reference
http://jsdoc.sourceforge.net/#tagref

JsDoc Toolkitによる開発効率向上を
目指して
http://www.atmarkit.co.jp/fcoding/articles/jsdoc/01/jsdoca.html

NetBeans6.7 の解釈

参考 http://www.netbeans.org/kb/61/ide/javascript-editor_ja.html

  /**
   * @param  {Array} list
   * @param  {Number} i
   * @return {HogeMoge}
   */
  function(list, i){
     ...
  }

• @typeは認識しない。
• 型名は{}で囲む必要がある。
• 関数のみで、変数には適用できない。
• @privateで鍵マーク表示
• @constructorでnew補完
• @class
• @namespace
• @ignore