“/ *(非javadoc)”是否有一个易于理解的含义?

/* (non-javadoc)是否有意义,除了向源代码的读者指出注释块有意不是Javadoc注释? 最近我看到很多代码看起来像这样:

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

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

根据我可以找到的信息 ,这是为了修复JavaDoc工具的旧版本中的错误(或者更可能是Eclipse的JavaDoc注释处理的旧版本),这些错误无法显示覆盖方法的方法的正确文档。父类。

如Konstantin所述,Eclipse的覆盖模板包含此文本。

除了作为评论之外,它没有确定的含义。 格式化是常见Eclipse代码格式化模板的结果,这解释了它的通用性。