Eclipse - @SuppressWarnings (javadoc) не работает

Мой Eclipse настроен на отображение предупреждений об отсутствующих комментариях и тегах javadoc для общедоступных элементов. Это очень полезно для меня, чтобы мой код был хорошо документирован.

Но иногда у меня есть класс, где у меня есть несколько констант, описывающих, например, состояния DFA или что-то в этом роде. Нет необходимости документировать эти константы, потому что они говорят сами за себя.

Поэтому я добавил аннотацию @SuppressWarnings("javadoc") в класс, и вот моя точка зрения: Eclipse не учитывает аннотацию и по-прежнему показывает предупреждения об отсутствующих javadocs.

@SuppressWarnings("all") выполняет свою работу, но имеет нежелательные побочные эффекты ;-)

Вы испытываете ту же проблему? Это баг или у меня что-то не так настроено? Есть ли обходной путь? Или это исправлено в новых версиях?

PS: я использую Версия: 3.3.2 Идентификатор сборки: M20080221-1800


person Martin Lazar    schedule 04.06.2009    source источник
comment
У меня такая же проблема на версии 3.4.1 (M20080911-1700)   -  person banjollity    schedule 04.06.2009


Ответы (3)


Я обнаружил эту ошибку, которая до сих пор не устранена.

person Andrew Niefer    schedule 04.06.2009
comment
Ну, похоже, что суть ошибки в том, что они хотят подавить все предупреждения с помощью @SuppressWarnings(), но компилятор продолжает показывать предупреждения javadoc. Это можно сделать с помощью @SuppressWarnings(all). Во-вторых, ошибка уже открыта более 2 лет :/ - person Martin Lazar; 04.06.2009
comment
Наконец-то они выпустили исправление для 3.7M6 - bugs.eclipse.org/bugs. /show_bug.cgi?id=179566 - person Martin Lazar; 14.02.2011

В конце на этой странице вы найдете все параметры SuppressWarning, которые обрабатываются в Eclipse. К сожалению, в настоящее время нет поддержки подавления только предупреждений javadoc. Ошибка, упомянутая Эндрю, на самом деле является запросом на добавление этой функции, но, похоже, она имеет низкий приоритет (вы можете проголосовать за эту ошибку, чтобы показать разработчикам Eclipse важность этой функции для вас).

person Csaba_H    schedule 16.06.2009

Вы пробовали "allJavadoc"?

person LB40    schedule 04.06.2009
comment
Извините, забыл упомянуть об этом - я пробовал это, но Eclipse не принимает это. Он показывает предупреждение Необработанный токен предупреждения allJavadoc - так что теперь у меня есть еще одно предупреждение :-D - person Martin Lazar; 04.06.2009