@description
描述: 描述一个标识.
别名:@desc
Syntax(语法)
@description <some description>
Overview(概述)
@description
标签允许您提供一般描述。该说明可能包括HTML标签。如果markdown 插件启用的话,它也可包括Markdown格式。
Examples(例子)
如果在注释开始的地方添加描述,那么可省略@description
标签。
例如,不用@description标签描述一个标识:
/**
* Add two numbers.
* @param {number} a
* @param {number} b
* @returns {number}
*/
function add(a, b) {
return a + b;
}
如果通过使用@description标签添加描述,你可以将描述放置在JSDoc注释的任何地方。
例如,用@description标签描述一个标识:
/**
* @param {number} a
* @param {number} b
* @returns {number}
* @description Add two numbers.
*/
function add(a, b) {
return a + b;
}