有没有评论JavaScript代码的工具？

Question

是否有任何javascript评论工具,因为它在c#像ghost doc.

/// <summary>
///   Method to calculate distance between two points
/// </summary>
/// <param name="pointA">First point</param>
/// <param name="pointB">Second point</param>
function calculatePointDistance(pointA, pointB)
 { 
    ... 
 }

有任何工具可以自动添加上面的评论.就像在c#代码中的ghost doc一样:

/// <summary>
///   Method to calculate distance between two points
/// </summary>
/// <param name="pointA">First point</param>
/// <param name="pointB">Second point</param>
private void calculatePointDistance(pointA, pointB)
{
  .....
}

我想在客户端,javascript中做类似的事情

Answer 1

是(但更像是Javadoc) - 看看JSDoc 基本上你在评论中使用类似Javadoc的特殊语法,例如@param在下面的例子中,然后解析器将为你生成好看的HTML输出

/**
* Shape is an abstract base class. It is defined simply
* to have something to inherit from for geometric 
* subclasses
* @constructor
*/
function Shape(color){
    this.color = color;
}