javascript - 如何让 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 的问题。

score 3 · Accepted Answer

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

function foo(bar){
   return bar;
};

事情是 Eclipse 为声明生成文档！用于声明函数的赋值表达式与类似的表达式没有什么不同x=1;，Eclipse 不会为表达式生成文档。

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

score 1 · Accepted Answer

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

score 0 · Accepted Answer

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

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

默认值为：

/**
 * ${tags}
 */

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

3 回答 3