java - "/* (non-javadoc)"有很好理解的含义吗？

Question

除了向源代码的读者指出注释 block 故意不是 Javadoc 注释之外，/* (non-javadoc) 是否有意义？最近看到很多这样的代码:

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

这是某种既定的惯例吗？如果是这样，它是什么意思(超出明显的字面意思)以及何时使用？

Answer 1

根据info I could find ，这是为了修复 JavaDoc 工具的旧版本(或更可能是 Eclipse 处理 JavaDoc 注释的旧版本)中的一个错误，该错误不会显示覆盖父类方法的方法的正确文档。

正如 Konstantin 所说，Eclipse 的覆盖模板包括此文本。