YUIDOC-返回回调的文档参数

Question

如何正确地记录返回多个参数的回调。示例：

return callback(error, success);

Answer 1

我会将此返回值记录如下：

/**
 * @return {Function} Returns the callback in the form of `callback(error, success)`
 */

也就是说——使用return语句的实际字符串描述。（YUIDoc实际上并没有能力在没有文本描述的情况下显式地记录您想要的内容。）