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

javadoc creation needs jsr305

    XMLWordPrintableJSON

    Details

    • Type: Bug
    • Status: Resolved
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: 1.6.0, 1.4.11
    • Component/s: documentation, website
    • Labels:
      None

      Description

      Cryptic failure trying to build beta-1 RC. Fails like this:

      [INFO] BUILD FAILURE
      [INFO] ------------------------------------------------------------------------
      [INFO] Total time: 03:54 min
      [INFO] Finished at: 2017-12-29T01:13:15-08:00
      [INFO] Final Memory: 381M/9165M
      [INFO] ------------------------------------------------------------------------
      [ERROR] Failed to execute goal org.apache.maven.plugins:maven-site-plugin:3.4:site (default-site) on project hbase: Error generating maven-javadoc-plugin:2.10.3:aggregate:
      [ERROR] Exit code: 1 - warning: unknown enum constant When.ALWAYS
      [ERROR] reason: class file for javax.annotation.meta.When not found
      [ERROR] warning: unknown enum constant When.UNKNOWN
      [ERROR] warning: unknown enum constant When.MAYBE
      [ERROR] /home/stack/hbase.git/hbase-common/src/main/java/org/apache/hadoop/hbase/CellUtil.java:762: warning - Tag @link: malformed: "#matchingRows(Cell, byte[]))"
      [ERROR] /home/stack/hbase.git/hbase-common/src/main/java/org/apache/hadoop/hbase/CellUtil.java:762: warning - Tag @link: reference not found: #matchingRows(Cell, byte[]))
      [ERROR] /home/stack/hbase.git/hbase-common/src/main/java/org/apache/hadoop/hbase/CellUtil.java:762: warning - Tag @link: reference not found: #matchingRows(Cell, byte[]))
      [ERROR] javadoc: warning - Class javax.annotation.Nonnull not found.
      [ERROR] javadoc: error - class file for javax.annotation.meta.TypeQualifierNickname not found
      [ERROR]
      [ERROR] Command line was: /home/stack/bin/jdk1.8.0_151/jre/../bin/javadoc -J-Xmx2G @options @packages
      [ERROR]
      [ERROR] Refer to the generated Javadoc files in '/home/stack/hbase.git/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] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException
      

      javax.annotation.meta.TypeQualifierNickname is out of jsr305 but we don't include this anywhere according to mvn dependency.

      Happens building the User API both test and main.

      Excluding these lines gets us passing again:

        3511               <doclet>
        3512                 org.apache.yetus.audience.tools.IncludePublicAnnotationsStandardDoclet
        3513               </doclet>
        3514               <docletArtifact>
        3515                 <groupId>org.apache.yetus</groupId>
        3516                 <artifactId>audience-annotations</artifactId>
        3517                 <version>${audience-annotations.version}</version>
        3518               </docletArtifact>
      + 3519               <useStandardDocletOptions>true</useStandardDocletOptions>
      

      Tried upgrading to newer mvn site (ours is three years old) but that a different set of problems.

        Attachments

        1. script.sh
          0.1 kB
          Michael Stack
        2. HBASE-19663-branch-1.4.v0.patch
          0.9 kB
          Sean Busbey

          Issue Links

            Activity

              People

              • Assignee:
                busbey Sean Busbey
                Reporter:
                stack Michael Stack
              • Votes:
                0 Vote for this issue
                Watchers:
                11 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: