Uploaded image for project: 'HBase'
  1. HBase
  2. HBASE-25983

javadoc generation fails on openjdk-11.0.11+9

    XMLWordPrintableJSON

Details

    • Bug
    • Status: Resolved
    • Major
    • Resolution: Fixed
    • 2.4.3
    • 2.6.0, 3.0.0-alpha-4, 2.5.2, 2.4.16
    • documentation, pom
    • None

    • maven - 3.5.4 and 3.6.2

      java - openjdk 11.0.11+9

      centos6

      hbase - 2.4.3

    • Reviewed

    Description

      I'm trying to build javadoc for HBase 2.4.3 on jdk11. The command I'm running is as follows:

      JAVA_HOME=/usr/lib/jvm/java-11-openjdk-11.0.11.0.9-2.el8_4.x86_64/  mvn -Phadoop-3.0 -Phadoop.profile=3.0 -Dhadoop-three.version=3.2.2 -Dhadoop.guava.version=27.0-jre -Dslf4j.version=1.7.25 -Djetty.version=9.3.29.v20201019 -Dzookeeper.version=3.5.7 -DskipTests -Dcheckstyle.skip=true site

      I've tried this with maven 3.5.4 and 3.6.2. Based on JAVA_HOME above, jdk11.0.11+9.

      The error is as follows:

      [ERROR] Failed to execute goal org.apache.maven.plugins:maven-site-plugin:3.7.1:site (default-site) on project hbase: Error generating maven-javadoc-plugin:3.2.0:aggregate-no-fork report:
 [ERROR] Exit code: 1 - javadoc: warning - The old Doclet and Taglet APIs in the packages
 [ERROR] com.sun.javadoc, com.sun.tools.doclets and their implementations
 [ERROR] are planned to be removed in a future JDK release. These
 [ERROR] components have been superseded by the new APIs in jdk.javadoc.doclet.
 [ERROR] Users are strongly recommended to migrate to the new APIs.
 [ERROR] javadoc: error - invalid flag: -author
 [ERROR]
 [ERROR] Command line was: /usr/lib/jvm/java-11-openjdk-11.0.11.0.9-2.el8_4.x86_64/bin/javadoc -J-Xmx2G @options @packages
 [ERROR]
 [ERROR] Refer to the generated Javadoc files in '/hbase/rpm/build/BUILD/hbase-2.4.3/target/site/apidocs' dir.
 [ERROR] -> [Help 1]
 [ERROR]
 [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
 [ERROR] Re-run Maven using the -X switch to enable full debug logging.
 [ERROR]
 [ERROR] For more information about the errors and possible solutions, please read the following articles:
 [ERROR] [Help 1]

      I believe this is due to the yetus doclet org.apache.yetus.audience.tools.IncludePublicAnnotationsStandardDoclet. Commenting this doclet out from the userapi and testuserapi reportSets in pom.xml fixes the build.

       
      I noticed hbase 2.4.3 depends on audience-annotations 0.5.0, which is very old. I tried updating to 0.13.0, but that did not help. 

      Attachments

        Issue Links

          is broken by

          Bug - A problem which impairs or prevents the functions of the product. YETUS-1197 NPE in DocletEnvironmentProcessor

          • Major - Major loss of function.
          • Resolved
          is related to

          Umbrella - An overarching type made of sub-tasks HBASE-22972 [JDK11] Support JDK11 LTS in HBase

          • Major - Major loss of function.
          • Resolved
          relates to

          Sub-task - The sub-task of the issue HBASE-27024 The User API and Developer API links are broken on hbase.apache.org

          • Major - Major loss of function.
          • Resolved
          links to

          Web Link GitHub Pull Request #4837

          Activity

            People

              zhangduo Duo Zhang
              bbeaudreault Bryan Beaudreault
              Votes:
              0 Vote for this issue
              Watchers:
              6 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: