oshi: maven-javadoc-plugin 3.2.0 breaks release

I was repeatedly unable to successfully execute mvn release:perform with the latest version of the javadoc plugin. Rolling back to 3.1.1 caused no problems. I can’t see anything obvious about what might have changed and would appreciate the help of someone more experienced in maven trying to troubleshoot this.

It works fine on the oshi-core artifact but fails on the shaded version.

Log right before the errors posted below.

    Building index for all the packages and classes...
    Generating /Users/danielwiddis/git/oshi/target/checkout/oshi-core-shaded/target/apidocs/overview-tree.html...
    Generating /Users/danielwiddis/git/oshi/target/checkout/oshi-core-shaded/target/apidocs/deprecated-list.html...
    Generating /Users/danielwiddis/git/oshi/target/checkout/oshi-core-shaded/target/apidocs/index.html...
    Generating /Users/danielwiddis/git/oshi/target/checkout/oshi-core-shaded/target/apidocs/index-all.html...
    Building index for all classes...
    Generating /Users/danielwiddis/git/oshi/target/checkout/oshi-core-shaded/target/apidocs/allclasses-index.html...
    Generating /Users/danielwiddis/git/oshi/target/checkout/oshi-core-shaded/target/apidocs/allpackages-index.html...
    Generating /Users/danielwiddis/git/oshi/target/checkout/oshi-core-shaded/target/apidocs/overview-summary.html...
    Generating /Users/danielwiddis/git/oshi/target/checkout/oshi-core-shaded/target/apidocs/help-doc.html...
    1 error
    [INFO] ------------------------------------------------------------------------
    [INFO] Reactor Summary for Operating System and Hardware Information 4.5.1:
    [INFO] 
    [INFO] Operating System and Hardware Information .......... SUCCESS [01:16 min]
    [INFO] oshi-core .......................................... SUCCESS [04:42 min]
    [INFO] oshi-core-shaded ................................... FAILURE [  6.868 s]
    [INFO] oshi-demo .......................................... SKIPPED
    [INFO] oshi-dist .......................................... SKIPPED
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD FAILURE
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time:  06:05 min
    [INFO] Finished at: 2020-03-19T16:40:04-07:00
    [INFO] ------------------------------------------------------------------------
    [ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:3.2.0:jar (javadoc-jar) on project oshi-core-shaded: MavenReportException: Error while generating Javadoc: 
    [ERROR] Exit code: 1 - javadoc: error - Error reading file: /Users/danielwiddis/git/oshi/target/checkout/oshi-core-shaded/target/apidocs/../apidocs/element-list
    [ERROR] 
    [ERROR] Command line was: /usr/local/opt/openjdk/bin/javadoc @options @packages

About this issue

Original URL
State: closed
Created 4 years ago
Comments: 57 (53 by maintainers)

Most upvoted comments

OK… the original requestor of the shaded jar doesn’t use it any more. I only found one dependency “in the wild” that imports the dependency and they’re still on 5.3.6.

I think there’s a bug somewhere in the javadoc plugin but it’s obscure enough that I’m not going to find it and I’ve wasted too many hours on this.

I’m going to merge #1866 because it’s a good idea anyway, and then delete the shaded jar configuration. If someone needs it, they can add it back, properly set up.

dbwiddis on Jan 25, 2022

I’m not sure to be honest. Probably an older version

lprimak on Jan 24, 2022

For the record, attempted a release today with 3.3.0 and got the same symptoms. Rolling back to 3.1.1 (again).

didn’t see this… reverting #1652

mprins on May 31, 2021