“ / *（非javadoc）”是否具有易于理解的含义？

Question

是否/* (non-javadoc)有一个含义，超越指出，以源代码的读者，一个注释块是不是故意Javadoc注释？最近，我看到了很多看起来像这样的代码：

/*
 * (non-javadoc)
 *
 * This method converts widgets to gizmos
 */
public Foo bar() {
   ...

这是某种既定的惯例吗？如果是这样，它是什么意思（除了明显的字面意义之外），什么时候使用？

Answer 1

根据我能找到的信息，这是为了修复JavaDoc工具的较旧版本（或更可能是Eclipse处理JavaDoc注释的较旧版本）中的错误，该错误将不会显示替代a方法的正确文档。家长班。

正如康斯坦丁（Konstantin）指出的那样，Eclipse的替代模板包括此文本。