Check in link-jdk-sources script enabling jdk-inherited javadocs

    mvn clean
    link-jdk-sources
    mvn package -P apidoc javadoc:aggregate-jar -DskipTests
    mvn verify -P release -Dgpg.skip=true

See also:

-   https://docs.oracle.com/en/java/javase/21/docs/specs/javadoc/doc-comment-spec.html#comment-inheritance
-   https://ss64.com/nt/for.html
-   `mklink /?`

link-jdk-sources.cmd

@@ -0,0 +1,20 @@
+@echo off
+rem # mvn clean
+rem # link-jdk-sources
+rem # mvn package -P apidoc javadoc:aggregate-jar -DskipTests
+rem # mvn verify -P release -Dgpg.skip=true
+
+setlocal
+set apidocs_src=target\apidocs\src
+set JDK_HOME=%JAVA_HOME%
+
+for %%M in (. xbrz-core xbrz-awt xbrz-tool) do (
+  mkdir %%M\%apidocs_src%
+)
+
+rem # src.zip needs to be extracted as "src" directory
+for /d %%D in (%JDK_HOME%\lib\src\*) do (
+  for %%M in (. xbrz-core xbrz-awt xbrz-tool) do (
+    mklink /d %%M\%apidocs_src%\%%~nxD %%D
+  )
+)