我们已将Java项目升级到JDK 10.运行构建脚本时,Javadoc会输出警告:
javadoc: warning - You have not specified the version of HTML to use.
The default is currently HTML 4.01, but this will change to HTML5
in a future release. To suppress this warning, please specify the
version of HTML used in your documentation comments and to be
generated by this doclet, using the -html4 or -html5 options.
为了构建项目,我们使用 gradle 。我们如何在gradle中指定HTML 5(-html5
)?
到目前为止,build.gradle
文件的 javadoc 部分相当简单:
javadoc {
include 'com/company/project/pkg/*'
}
答案 0 :(得分:6)
options.addBooleanOption
:
javadoc {
include 'com/company/project/pkg/*'
options.addBooleanOption('html5', true)
}
请注意,您必须使用addBooleanOption
而不是addStringOption
。后者在没有值(例如""
)的情况下不起作用,然后产生无效的命令行。
答案 1 :(得分:5)
在为您的maven项目获取上述错误时,可以将以下代码段放入pom.xml
中:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>${javadocplugin.version}</version>
<executions>
<execution>
<id>attach-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
<configuration>
<additionalOptions>-html5</additionalOptions>
</configuration>
</plugin>