如何让 Eclipse 在 Javascript 文档中执行自动 javadoc 注释

Question

在Eclipse中编写javascript函数时，我想使用自动注释功能。我已经看到它可以在其他人的计算机上工作，但它并没有抓住我机器上的@params。

当我有

var foo = function(bar){
    // do stuff
    return bar;
}

在我键入/** 并按回车键的函数之前的行上，我得到：

/**
 * 
 */
var foo = function(bar){
    // do stuff
    return bar;
}

我应该得到：

/**
 * 
 * @param bar
 */
var foo = function(bar){
    // do stuff
    return bar;
}

有什么想法吗？这似乎是Eclipse中的某些设置不正确，而不是Javascript特有的问题。

Answer 1

尝试像这样声明你的函数：

function foo(bar){
   return bar;
};

问题是 Eclipse 为声明生成文档！用于声明函数的赋值表达式与 x=1; 等表达式没有什么不同，并且 Eclipse 不会为表达式生成文档。

我建议看看这个问题。它解释了函数声明的差异。

Answer 2

假设 Juno 和项目"包含路径"上的文件，您希望生成"元素"注释（从"大纲"视图或"源"菜单或"添加 JSDoc 注释"命令），而不是通过键入它来执行此操作，尽管当我尝试它时，它并没有像我预期的那样整齐。

Answer 3

我没有使用 JavaScript，只是使用纯 Java，但生成的 Java 代码注释的设置在这里：

Window -> preferences -> Java -> Code Style -> Code Templates  ->
 Comments -> Methods

默认值为 ：

/**
 * ${tags}
 */

所以我想你需要在Window -> preferences -> JavaScript -> ...中设置类似的东西