disable javadoc for modules which don’t have a public or protected clases

[sdelamo]

javadoc fails with:

error: No public or protected classes found to document.

[sdelamo]

Even javadoc is disabled for micronaut-langchain-jlama modules, a module compatible only with 21 and with no public or protected classes, running global javadoc fails with:

./gradlew javadoc
Type-safe project accessors is an incubating feature.
Project accessors enabled, but root project name not explicitly set for 'buildSrc'. Checking out the project in different folders will impact the generated code and implicitly the buildscript classpath, breaking caching.

> Task :javadoc FAILED
/Users/sdelamo/github/micronaut-projects/micronaut-langchain4j/micronaut-langchain4j-jlama/build/aggregation/javadoc/io/micronaut/langchain4j/jlama/JlamaModule.java:21: error: cannot access JlamaChatModel
import dev.langchain4j.model.jlama.JlamaChatModel;
                                  ^
  bad class file: /Users/sdelamo/.gradle/caches/modules-2/files-2.1/dev.langchain4j/langchain4j-jlama/0.35.0/81c627ec5dfca426264627c3b9b04167b20688ee/langchain4j-jlama-0.35.0.jar(/dev/langchain4j/model/jlama/JlamaChatModel.class)
    class file has wrong version 65.0, should be 61.0
    Please remove or make sure it appears in the correct subdirectory of the classpath.
/Users/sdelamo/github/micronaut-projects/micronaut-langchain4j/micronaut-langchain4j-jlama/build/aggregation/javadoc/io/micronaut/langchain4j/jlama/JlamaModule.java:22: error: cannot access JlamaEmbeddingModel
import dev.langchain4j.model.jlama.JlamaEmbeddingModel;
                                  ^
  bad class file: /Users/sdelamo/.gradle/caches/modules-2/files-2.1/dev.langchain4j/langchain4j-jlama/0.35.0/81c627ec5dfca426264627c3b9b04167b20688ee/langchain4j-jlama-0.35.0.jar(/dev/langchain4j/model/jlama/JlamaEmbeddingModel.class)
    class file has wrong version 65.0, should be 61.0
    Please remove or make sure it appears in the correct subdirectory of the classpath.
/Users/sdelamo/github/micronaut-projects/micronaut-langchain4j/micronaut-langchain4j-jlama/build/aggregation/javadoc/io/micronaut/langchain4j/jlama/JlamaModule.java:23: error: cannot access JlamaStreamingChatModel
import dev.langchain4j.model.jlama.JlamaStreamingChatModel;
                                  ^
  bad class file: /Users/sdelamo/.gradle/caches/modules-2/files-2.1/dev.langchain4j/langchain4j-jlama/0.35.0/81c627ec5dfca426264627c3b9b04167b20688ee/langchain4j-jlama-0.35.0.jar(/dev/langchain4j/model/jlama/JlamaStreamingChatModel.class)
    class file has wrong version 65.0, should be 61.0
    Please remove or make sure it appears in the correct subdirectory of the classpath.
/Users/sdelamo/github/micronaut-projects/micronaut-langchain4j/micronaut-langchain4j-jlama/build/aggregation/javadoc/io/micronaut/langchain4j/jlama/JlamaModule.java:35: error: cannot find symbol
            impl = JlamaChatModel.class)
                   ^
  symbol: class JlamaChatModel
/Users/sdelamo/github/micronaut-projects/micronaut-langchain4j/micronaut-langchain4j-jlama/build/aggregation/javadoc/io/micronaut/langchain4j/jlama/JlamaModule.java:39: error: cannot find symbol
            impl = JlamaStreamingChatModel.class
                   ^
  symbol: class JlamaStreamingChatModel
/Users/sdelamo/github/micronaut-projects/micronaut-langchain4j/micronaut-langchain4j-jlama/build/aggregation/javadoc/io/micronaut/langchain4j/jlama/JlamaModule.java:43: error: cannot find symbol
            impl = JlamaEmbeddingModel.class
                   ^
  symbol: class JlamaEmbeddingModel
6 errors

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':javadoc'.
> Javadoc generation failed. Generated Javadoc options file (useful for troubleshooting): '/Users/sdelamo/github/micronaut-projects/micronaut-langchain4j/build/tmp/javadoc/javadoc.options'

* Try:
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Get more help at https://help.gradle.org.

Deprecated Gradle features were used in this build, making it incompatible with Gradle 9.0.

You can use '--warning-mode all' to show the individual deprecation warnings and determine if they come from your own scripts or plugins.

For more on this, please refer to https://docs.gradle.org/8.10.2/userguide/command_line_interface.html#sec:command_line_warnings in the Gradle documentation.

BUILD FAILED in 1s

@melix any idea what we could do to workaround this?

[melix]

Let me take a look at the Java 21 issue, but I think the initial problem, which is disabling javadoc for some modules, will not work when publishing to Maven Central, because javadocs are mandatory.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarCloud

[melix]

Issue should be fixed now. The empty javadocs are not a problem. Should they be, a better solution than disabling the javadocs would be to create a package-info.java file.