2012-09-25 39 views
14

是否有與Maven構建時防止警告的Javadoc的簡單方法/選項?我們使用soyatec uml插件進行日食,並插入特殊標籤,這些標籤會使我們的構建引發大量惱人的警告;我環顧四周,包括soyatec網站,並已空出來。殺害的Javadoc警告,特定的標記

 
@uml.property is an unknown tag 

回答

14

我能找到的唯一答案是Configuring Custom Javadoc Tags

一個例子可以是這樣的:

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

在運行,你會看到這樣的輸出:

mvn javadoc:javadoc 

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

,您可以通過使用該禁用非錯誤和不警告消息命令:

mvn javadoc:javadoc -Dquiet 

定義所有這些標籤可能非常困難,但一旦完成,您將不再看到警告。

而且你應該在父POM,每個人都可以用它來造福所有的工作定義這些自定義標記。

+0

在哪個文件中必須添加此自定義標籤? – Radon8472

+0

@ Radon8472在pom.xml文件中。 – maba