[MDSAL-419] mdsal/docs build fails under Java 11 due to JavaDoc error Created: 28/Jan/19  Updated: 28/Jan/19  Resolved: 28/Jan/19

Status: Resolved
Project: mdsal
Component/s: None
Affects Version/s: 3.0.7
Fix Version/s: 3.0.7

Type: Bug Priority: Medium
Reporter: Michael Vorburger Assignee: Robert Varga
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   
[INFO] --- maven-javadoc-plugin:3.0.0:jar (attach-javadocs) @ mdsal-docs ---
[ERROR] Error fetching link: /home/vorburger/dev/ODL/git/mdsal/binding/mdsal-binding-test-utils/target/apidocs/package-list. Ignored it.
[INFO] 
1 error
100 warnings

...

[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:3.0.0:jar (attach-javadocs) on project mdsal-docs: MavenReportException: Error while generating Javadoc: 
[ERROR] Exit code: 1 - javadoc: warning - You have specified the HTML version as HTML 4.01 by using the -html4 option.
[ERROR] The default is currently HTML5 and the support for HTML 4.01 will be removed
[ERROR] in a future release. To suppress this warning, please ensure that any HTML constructs
[ERROR] in your comments are valid in HTML5, and remove the -html4 option.
[ERROR] javadoc: error - Error fetching URL: https://static.javadoc.io/junit/junit/4.11/
[ERROR] /home/vorburger/dev/ODL/git/mdsal/docs/target/src/org/opendaylight/yangtools/yang/binding/InstanceIdentifier.java:35: warning: empty <p> tag
[ERROR]  * <p>
[ERROR]    ^
[ERROR] /home/vorburger/dev/ODL/git/mdsal/docs/target/src/org/opendaylight/mdsal/binding/api/ActionProviderService.java:45: warning: no @param for <O>
[ERROR]         ObjectRegistration<S> registerImplementation(Class<T> actionInterface, S implementation,
...


 Comments   
Comment by Michael Vorburger [ 28/Jan/19 ]

FTR: This can of course be worked around using -Dmaven.javadoc.skip=true ...

PS: I'm raising this as a bug because we're starting to get -1 for strictly Java 11 specific issues, e.g. in https://git.opendaylight.org/gerrit/#/c/79888/ ...

Comment by Michael Vorburger [ 28/Jan/19 ]

> [ERROR] javadoc: error - Error fetching URL: https://static.javadoc.io/junit/junit/4.11/

indeed on https://static.javadoc.io/junit/junit/4.11/ one hits "AccessDeniedAccess Denied" ... perhaps using https://junit.org/junit4/javadoc/latest/ would be better?

Generated at Wed Feb 07 20:09:45 UTC 2024 using Jira 8.20.10#820010-sha1:ace47f9899e9ee25d7157d59aa17ab06aee30d3d.