Template fails to build javadocs

[alanocallaghan]

Template fails to build javadocs

[petebankhead]

Hmmm, builds for me but with a complaint.
PR now with an attempted fix (which also gets rid of the complaint).

[alanocallaghan]

Very odd, even changing the javadocs the issue persists for me on a cloned copy, though using the IDE setup steps works fine.

[alanocallaghan]

If it's only my machine then I'll dig into it properly tomorrow

[petebankhead]

Have you checked the generated javadoc options file for clues?

I've seen small javadoc errors kill a build, but the default is to kindly ask the javadoc to not be so petty: https://github.com/qupath/qupath-extension-template/blob/main/build.gradle#L99

[alanocallaghan]

I can't spot anything obvious, all of the listed directories exist and the other options all seem sensible too

[petebankhead]

Does it build successfully if you comment on the line withJavadocJar() ?
(I guess you've also tried gradlew clean)

[alanocallaghan]

Hadn't tried clean as I was working from a fresh clone, but it doesn't change anything. Removing withJavadocJar does allow me to build, yeah

[alanocallaghan]

Ah! It's trying to run /usr/lib/jvm/java-11-openjdk-amd64/bin/javadoc but
ls: cannot access '/usr/lib/jvm/java-11-openjdk-amd64/bin/javadoc': No such file or directory

Just a jdk config error by me

[petebankhead]

Hmmm, not an entirely satisfying solution though... only other thing i can think of is that you've got an unhappy JDK. Throwing

println System.properties['java.home']

into build.gradle should print whatever it's using. The easiest way to change is often to create a gradle.properties file and include (at least)

org.gradle.java.home=/path/to/jdk/

You can technically run Gradle with one JDK but build with another, thanks to toolchains - so conceivably the toolchain is hunting for some unexpected JDK to use.

I generally use the builds from Eclipse Temurin™ and that's also what is used with GitHub Actions here.

[alanocallaghan]

It's poor exception handling from gradle for sure, the issue is I have openjdk-11-jdk installed (and maybe some other packages) but not openjdk11-doc.

To be safe, possibly best to install openjdk[version]-*

[petebankhead]

Wow, I'm surprised those are two different things :/