Attempt to fix javadoc generation warning/fail

[slachiewicz]

It looks like the links section is problematic Adding a reference to Javadocs 21 generates the warning/fail.

[sebbASF]

What is the problem you are seeing?
Are you referring to the following:

Warning: Javadoc Warnings
Warning: [WARNING] warning: The code being documented uses packages in the unnamed module, but the packages defined in https://docs.oracle.com/en/java/javase/21/docs/api/ are in named modules.
Warning: [WARNING] 1 warning

[sebbASF]

This PR overrides the setting in the parent pom, so I think any changes need to be made there if possible. We don't want to have to add this fix to every component.

[garydgregory]

I'm not sure that's the solution anyway. The problem is that Javadoc doesn't know about the module name, so we probably need to point it to the module we generate at build time.

./target/moditect/generated-sources/org.apache.commons.csv/module-info.java
./target/moditect/org.apache.commons.csv/versions/9/module-info.java

I wonder if we might be stuck with this warning until we bump to Java 9+ because if I edit the Jaavdoc plugin config in the parent POM to point it to the generated module using sourcepath, then Javadoc errors out because we also use source set to 8.

[sebbASF]

It did fix the warning for me

[garydgregory]

But do you have links to everything like the JDK classes?

[sebbASF]

What links are you referring to?

[garydgregory]

Closing: This is now fixed in the parent POM. TY both 👍