Asesoramiento de advertencias de Javadoc para etiquetas específicas

Question

¿Hay alguna forma/opción fácil de evitar las advertencias de javadoc cuando se compila con Maven? Usamos el plugin soyatec uml para eclipse e inserta etiquetas especiales que hacen que nuestras compilaciones generen muchas advertencias molestas; He buscado en todo el sitio de soyatec y he estado vacío.

 
@uml.property is an unknown tag 

Answer 1

La única respuesta que pude encontrar es Configuring Custom Javadoc Tags.

Un ejemplo podría ser la siguiente:

<build> 
    <plugins> 
     <plugin> 
      <groupId>org.apache.maven.plugins</groupId> 
      <artifactId>maven-javadoc-plugin</artifactId> 
      <version>2.8.1</version> 
      <configuration> 
       <tags> 
        <tag> 
         <name>uml.property</name> 
         <!-- The value X makes javadoc ignoring the tag --> 
         <placement>X</placement> 
        </tag> 
        <tag> 
         <name>some.other.property</name> 
         <placement>X</placement> 
        </tag> 
        <tag> 
         <name>some.third.property</name> 
         <placement>X</placement> 
        </tag> 
       </tags> 
      </configuration> 
     </plugin> 
    </plugins> 
</build> 

Cuando se ejecuta verá esto en la salida:

mvn javadoc:javadoc 

<lots of output> 
Note: Custom tags that were not seen: @uml.property 
<maybe more output> 

Y se puede desactivar los mensajes no relacionados con errores y no de advertencia a través de este comando:

mvn javadoc:javadoc -Dquiet 

---

Puede ser un trabajo difícil definir todas estas etiquetas, pero una vez hecho esto ya no verá las advertencias.

Y probablemente debas definir estas etiquetas personalizadas en un pom principal que todos puedan usar para beneficiar todo el trabajo.