Killing Avvisi Javadoc per tag specifici

Question

C'è un modo semplice/opzione di prevenire gli avvisi javadoc quando si costruisce con Maven? Usiamo il plugin umy di soyatec per eclipse e inserisce tag speciali che fanno in modo che le nostre build generino molti fastidiosi avvertimenti; Mi sono guardato intorno incluso sul sito di soyatec e sono uscito vuoto.

 
@uml.property is an unknown tag 

Answer 1

L'unica risposta che ho trovato è Configuring Custom Javadoc Tags.

Un esempio potrebbe essere simile a questo:

<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> 

Durante l'esecuzione si vedrà questo nell'output:

mvn javadoc:javadoc 

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

E si può disattivare i messaggi non di errore e non di avviso utilizzando questo comando:

mvn javadoc:javadoc -Dquiet 

---

Potrebbe essere difficile definire tutti questi tag, ma una volta terminato non vedrete più gli avvertimenti.

E probabilmente dovresti definire questi tag personalizzati in un genitore principale che tutti possono usare per avvantaggiare tutto il lavoro.