[jira] [Comment Edited] (HBASE-25983) javadoc generation fails on openjdk-11.0.11+9

["Bryan Beaudreault (Jira)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/HBASE-25983?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17526609#comment-17526609 ] 

Bryan Beaudreault edited comment on HBASE-25983 at 4/22/22 6:05 PM:
--------------------------------------------------------------------

The full site does build, but I did just notice that I see these warnings:

 

java.lang.AbstractMethodError: Receiver class org.apache.maven.plugins.javadoc.AggregatorTestJavadocNoForkReport does not define or inherit an implementation of the resolved method 'abstract void generate(org.codehaus.doxia.sink.Sink, java.util.Locale)' of interface org.apache.maven.reporting.MavenReport.

The AggregatorJavadocNoForkReport receiver class also shows up with the same error.

 

This occurs for "Dependency Management", "Developer API", "Test Javadoc", "User API", and "Test Javadoc" reports. So the project summary and book and such are generated, but none of the actual apidocs. Not sure if this related though, does it work for you?


was (Author: bbeaudreault):
The full site does build, but I did just notice that I see these warnings:

 

java.lang.AbstractMethodError: Receiver class org.apache.maven.plugins.javadoc.AggregatorTestJavadocNoForkReport does not define or inherit an implementation of the resolved method 'abstract void generate(org.codehaus.doxia.sink.Sink, java.util.Locale)' of interface org.apache.maven.reporting.MavenReport.

 

This occurs for "Dependency Management", "Developer API", "Test Javadoc", "User API", and "Test Javadoc" reports. So the project summary and book and such are generated, but none of the actual apidocs. Not sure if this related though, does it work for you?

> javadoc generation fails on openjdk-11.0.11+9
> ---------------------------------------------
>
>                 Key: HBASE-25983
>                 URL: https://issues.apache.org/jira/browse/HBASE-25983
>             Project: HBase
>          Issue Type: Sub-task
>    Affects Versions: 2.4.3
>         Environment: maven - 3.5.4 and 3.6.2
> java - openjdk 11.0.11+9
> centos6
> hbase - 2.4.3
>            Reporter: Bryan Beaudreault
>            Priority: Major
>
> I'm trying to build javadoc for HBase 2.4.3 on jdk11. The command I'm running is as follows:
> {code:java}
> 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{code}
> 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:}}
> {code:java}
> [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]{code}
> 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. 



--
This message was sent by Atlassian Jira
(v8.20.7#820007)