8345136: Update JDK_DOCS property to point to JDK 23 docs

Reviewed-by: angorya, sykora, arapte

Author: kevinrushforth

build.gradle

@@ -303,6 +303,8 @@ void setFileTimestamps(Provider<RegularFile> archive, Instant instant) {
  *                                                                            *
  *****************************************************************************/
 
+loadProperties("$projectDir/build.properties")
+
 // If the ../rt-closed directory exists, then we are doing a closed build.
 // In this case, build and property files will be read from
 // ../rt-closed/closed-build.gradle and ../rt-closed/closed-properties.gradle
@@ -396,15 +398,13 @@ defineProperty("JAVA", cygpathExe("$JDK_HOME/bin/java"))
 defineProperty("JAVAC", cygpathExe("$JDK_HOME/bin/javac"))
 defineProperty("JAVADOC", cygpathExe("$JDK_HOME/bin/javadoc"))
 defineProperty("JMOD", cygpathExe("$JDK_HOME/bin/jmod"))
-defineProperty("JDK_DOCS", "https://docs.oracle.com/en/java/javase/21/docs/api/")
+defineProperty("JDK_DOCS", "https://docs.oracle.com/en/java/javase/${jdkDocsVersion}/docs/api/")
 defineProperty("JDK_JMODS", cygpath(System.getenv("JDK_JMODS")) ?: cygpath(System.getenv("JDK_HOME") + "/jmods"))
 
 defineProperty("libAVRepositoryURL", "https://github.com/libav/libav/archive")
 defineProperty("FFmpegRepositoryURL", "https://www.ffmpeg.org/releases/")
 defineProperty("icuRepositoryURL", "https://github.com/unicode-org/icu/releases/")
 
-loadProperties("$projectDir/build.properties")
-
 def supplementalPreBuildFile = file("$closedDir/closed-pre-build.gradle");
 def supplementalBuildFile = file("$closedDir/closed-build.gradle");
 

build.properties

@@ -73,6 +73,10 @@ javadoc.top=<div style="padding: 6px; text-align: center; font-size: 80%;">This
 # compile FX. This variable is read by the Hudson build scripts to
 # select the JDK.
 #
+# jdk.docs.version should be set to the JDK feature version used for
+# javadoc links to JDK classes from JavaFX classes. It is typically the
+# feature version corresponding to the JDK used to compile JavaFX.
+#
 # jfx.build.jdk.buildnum.min should be set to the lowest version that
 # supports building FX (which must be <= jfx.build.jdk.buildnum)
 #
@@ -83,6 +87,7 @@ javadoc.top=<div style="padding: 6px; text-align: center; font-size: 80%;">This
 ##############################################################################
 
 # JDK
+jdk.docs.version=23
 jfx.build.jdk.version=23
 jfx.build.jdk.buildnum=37
 jfx.build.jdk.version.min=22

gradle/verification-metadata.xml

@@ -135,9 +135,9 @@
             <sha256 value="2a8df69e6035788f8b9b20d23beaf3e5cbc64f17c78e9012db1689b677e712dd" origin="Generated by Gradle"/>
          </artifact>
       </component>
-      <component group="javafx" name="jdk-21_doc" version="all">
-         <artifact name="jdk-21_doc-all.zip">
-            <sha256 value="e85811ad50e9e9b5665700daa7bbdda456f1fb047eb5b222629d4431d983863b" origin="Generated by Gradle"/>
+      <component group="javafx" name="jdk-23_doc" version="all">
+         <artifact name="jdk-23_doc-all.zip">
+            <sha256 value="bcb93d726121f31162f8e76c434e8ca7995f98f27d88171aa917233f15ddbfa6" origin="Generated by Gradle"/>
          </artifact>
       </component>
       <component group="javafx" name="jfx-devkit-gcc" version="patch+1.1.tar">