JSDoc和JavaScript单例文档

时间:2012-09-07 10:05:29

标签: javascript jsdoc

我有一个JavaScript单例定义为:

/**
 * A description here
 * @class
 */
com.mydomain.ClassName = (function(){

/**
 * @constructor
 * @lends com.mydomain.ClassName
 */ 
var ClassName = function(){};

/**
 * method description
 * @public
 * @lends com.mydomain.ClassName
*/
ClassName.prototype.method1 = function(){};

return new ClassName();

})();

没有以详细模式(-v)打印警告,但文档仅报告“com.mydomain.ClassName()”以及“此处描述”作为描述...如何为ClassName的方法生成文档?

1 个答案:

答案 0 :(得分:7)

我解决了! :)

  /**
 * A description here
 * @class
 */
com.mydomain.ClassName = (function(){

/**
 * @constructor
 * @name com.mydomain.ClassName
 */ 
var ClassName = function(){};

/**
 * method description
 * @public
 * @name com.mydomain.ClassName.method1
*/
ClassName.prototype.method1 = function(){};

return new ClassName();

})();

我刚用@name替换了@lends

更新:获得完整文档的正确方法如下:

/**
 * A description here
 * @class
 */
com.mydomain.ClassName = (function(){

var ClassName = function(){};

/**
 * method description
 * @memberOf com.mydomain.ClassName
*/
ClassName.prototype.method1 = function(){};

return new ClassName();

})();