代码之家  ›  专栏  ›  技术社区  ›  PatS

maven javadoc插件不接受<additionalparam>-Xdoclint:none</additionalparam>

  •  1
  • PatS  · 技术社区  · 7 年前

    mvn release:perform 由于未创建javadocs,正在失败。所以我试着跑步

    mvn javadoc:javadoc
    

    Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:3.0.1:jar (attach-javadocs) on project my-project: MavenReportException: Error while generating Javadoc:
    
    Exit code: 1 - /my/file.java:36: warning: no description for @return
    

    然而,这曾经奏效。那么,发生了什么变化?

    我查看了maven javadoc插件文档,它现在(在v3.0中)说参数不是additionalParam或additionalParam,而是additionalOptions和additionalJOptions。看见 maven-javadoc-plugin documentation .

    Maven is not working in Java 8 when Javadoc tags are incomplete

    我怎样才能修好它?

    我试过的

    幸运的是,我找到了一个从命令行禁用Javadoc linting的方法:

    mvn release:perform -Darugments="-Dmaven.javadoc.skip=true"
    

    code.i-harness.com posting 这给了我这项工作。

    因此,我通过了最初的问题,但希望/需要清理POM以删除无用的参数,或者将它们更改为新的/正确的语法(尚未测试)。

    有用的搜索

    搜索SO会得到这些有用的点击:

    1 回复  |  直到 7 年前
        1
  •  12
  •   gjoranv    7 年前

    你应该使用 doclint 替代选项:

    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>3.0.1</version>
        <configuration>
            <doclint>none</doclint>
        </configuration>
    </plugin>
    

    none

            <doclint>all,-missing</doclint>
    

    可以打开或关闭单独的检查组(如 -missing 上文)。有关这些组的详细说明,请参见 javadoc documentation