Eclipse: cómo configurar las advertencias de javadoc solo para carpetas específicas, no para todo el proyecto

Question

Algunos de mis colegas carecen de disciplina y no siempre escriben la documentación de sus clases (no siempre = nunca). Estaba tratando de obligarlos a escribir documentación estableciendo advertencias de proyecto para javadocs de comentarios faltantes. Tenemos dos carpetas de origen 'src' y 'tests'; obviamente, no todos los métodos @Test necesitan documentación y esta advertencia no es redundante. Pero ahora todas las pruebas no documentadas recibieron estas advertencias molestas, el proyecto recibió cientos de advertencias y temo que se perderán algunas advertencias peligrosas (porque hay cientos de inútiles).

¿Cómo configurar las advertencias solo en la carpeta 'src' e ignorar las advertencias en la carpeta 'pruebas'?

Answer 1

Me temo que no hay ninguna configuración para desactivar la validación de javadoc falta estrictamente para las clases de prueba/métodos. Incluso hubo una sugerencia publicada en Eclipse bugzilla here pero finalmente llegó a un callejón sin salida.

La única forma no elegante de resolver este problema es mediante la anotación de esos métodos de prueba con la anotación @SuppressWarnings("javadoc").