如何僅使用JSDoc生成變量的文檔？

Question

我有JavaScript文件，其中包含很多全球增值稅的評論，但JSDoc不斷告訴「沒有文件，退出」。

這裏有一個例子：

/** 
* Name of the clients list 
* @type String 
* @final 
*/ 
var CLIENTS_LIST_NAME = "Client"; 

有沒有辦法生成文檔這樣的.js文件？

Answer 1

它看起來像你使用我的舊的基於Perl的項目名爲JSDoc.pm。我會建議您升級到我的較新的名爲JsDoc Toolkit的項目。較新項目的語法大多是舊項目中使用的標籤的超集，但請查看wiki on the JsDoc Toolkit project以獲取所有受支持標籤的完整列表。

以下將JsDoc工具包工作：

/** 
 * Name of the clients list 
 * @type String 
 * @constant 
 */ 
var CLIENTS_LIST_NAME = "Client";