Убийство предупреждений Javadoc для определенных тегов

Есть ли простой способ/вариант предотвращения предупреждений javadoc при создании с Maven? Мы используем плагин soyatec uml для eclipse и вставляем специальные теги, которые заставляют наши сборки вызывать множество раздражающих предупреждений; Я посмотрел вокруг, в том числе на сайте soyatec, и придумал пустой.

@uml.property is an unknown tag

Ответы

Ответ 1

Единственный ответ, который я смог найти, - это Настройка пользовательских тегов Javadoc.

Пример может быть таким:

<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

Трудно определить все эти теги, но после этого вы больше не увидите предупреждения.

И вы должны, вероятно, определить эти пользовательские теги в родительском помпе, который каждый может использовать, чтобы принести пользу всей работе.