有没有办法将所有注释都转换成javadoc注释？ [Eclipse/Java]

Question

我正在用 Eclipse 做一个 Java 学校作业，在最底部它说所有文档都应该在 Javadoc 中，但我已经使用 [=11 完成了所有评论=].

除了手动返回并将每个评论更改为 Javadoc 格式 /** */ 之外，还有更简单的方法吗？

谢谢。

Answer 1

Javadoc 是一种特定的注释格式，用于为您的代码生成外部文档。您不应该将常规注释转换为 Javadoc。

例如：

/**
 * Do foo with a.
 * @param a the a value
 * @return some different value
 * @see #bar
 */
public String foo(String a) {
    // blah blah blah
}

有关详细信息，请参阅 this technical doc。

不过，如果您确实想转换评论，则必须像您所说的那样手动进行。没有针对此的特定工具。