Имеет ли значение /* (non-javadoc) значение, не указывая читателю исходного кода, что блок комментариев намеренно не является комментарием Javadoc? В последнее время я видел много кода, который выглядит так:
/*
* (non-javadoc)
*
* This method converts widgets to gizmos
*/
public Foo bar() {
...
Является ли это установившейся конвенцией? Если да, то что это означает (за пределами очевидного буквального значения) и когда оно используется?
В соответствии с информацией, которую я мог найти, это должно было исправить ошибку в более старых версиях инструмента JavaDoc (или, скорее, более старую версию обработки Eclipse комментариев JavaDoc), которые не отображали бы правильную документацию для метода, который переопределяет метод родительского класса.
Как отметил Константин, шаблон переопределения Eclipse включает этот текст.
Он не имеет установленного значения, кроме комментария. Форматирование является результатом общих шаблонов форматирования кода Eclipse, что объясняет его общность.