Possible `javadoc` regression when upgrading from 21 to 25

[Stefano Cordio]

Hello everyone,

I am upgrading a project's build from Java 21 to Java 25, and Javadoc
generation fails with the following error:

[ERROR] Failed to execute goal
org.apache.maven.plugins:maven-javadoc-plugin:3.11.3:jar
(attach-javadoc) on project spring-batch-notion: MavenReportException:
Error while generating Javadoc:
[ERROR] Exit code: 1
[ERROR] /home/runner/work/spring-batch-extensions/spring-batch-extensions/spring-batch-notion/src/main/java/org/springframework/batch/extensions/notion/Sort.java:29:
error: reference not found
[ERROR]  * The direction defaults to {@link Direction#DEFAULT_DIRECTION}.
[ERROR]                                     ^
[ERROR] The generated documentation contains diagnostic markers for
invalid input.
[ERROR] 1 error
[ERROR] Command line was:
/usr/lib/jvm/temurin-25-jdk-amd64/bin/javadoc -J-Duser.language=
-J-Duser.country= @options @packages
[ERROR]
[ERROR] Refer to the generated Javadoc files in
'/home/runner/work/spring-batch-extensions/spring-batch-extensions/spring-batch-notion/target/reports/apidocs'
dir.


Given that it was working fine on 21, I imagine it could be a regression.

Reference:
https://github.com/spring-projects/spring-batch-extensions/pull/192

Thanks in advance for any feedback!

Best regards,
Stefano
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.org/pipermail/javadoc-dev/attachments/20251111/a0441d0f/attachment.htm>