Eclipse - как установить предупреждения Javadoc только для определенных папок, а не для всего проекта - PullRequest
6 голосов
/ 25 ноября 2011

Некоторым моим коллегам не хватает дисциплины, и они не всегда пишут документацию своих классов (не всегда = никогда). Я пытался заставить их писать документацию, устанавливая предупреждения проекта для отсутствующих комментариев Javadocs. Мы получили две исходные папки 'src' и 'tests' - очевидно, не все методы @Test нуждаются в документации, и это предупреждение является избыточным. Но теперь все недокументированные тесты получили эти надоедливые предупреждения, проект получил сотни предупреждений, и я боюсь, что некоторые действительно опасные предупреждения будут пропущены (потому что есть сотни бесполезных).

Как установить предупреждения только в папке 'src' и игнорировать предупреждения в папке 'tests'?

1 Ответ

5 голосов
/ 25 ноября 2011

Боюсь, что нет настройки, позволяющей отключить отсутствующую валидацию Javadoc строго для тестовых классов / методов. Даже в Eclipse bugzilla здесь было опубликовано предложение, но в итоге оно зашло в тупик.

Единственный, не изящный способ решения этой проблемы - аннотирование этих методов тестирования аннотацией @SuppressWarnings("javadoc").

...