Yuidoc:指定参数的性质

时间:2013-04-30 08:31:14

标签: javascript node.js yuidoc

我正在尝试使用yuidoc(http://yui.github.io/yuidoc/)记录我的node.js模块,我想知道如何创建从param到其实现的链接。

假设我有以下src/core/Repo.js

/**
 * Repo
 * @class Repo
 * @module core
 */
var Repo = function() {
  /**
   * Insert stuff
   * @param {Object} obj - some stuff
   * @param {Function} callback - error/success callback
   */
  var _insert() = function(obj, callback) {
  }
  return {
    insert : _insert
  }
}
module.exports = Repo;

src/routing/Routes.js

/**
 * Routes
 * @class Routes
 * @module routing
 * @param {Repo} repo - the repo object (from repo.js)
 */
var Routes = function(repo) {
}
modules.exports = Routes;

如何告诉Routes函数接受一个Repo对象,以便让yuidoc在html文档中生成正确的超链接? (上面的代码段似乎不起作用)

1 个答案:

答案 0 :(得分:1)

所以,添加@constructor标签很简单!像这样:

/**
 * Routes
 * @class Routes
 * @constructor
 * @module routing
 * @param {Repo} repo - the repo object
 */
var Routes = function(repo) {
}
modules.exports = Routes;