On Thu, 6 Aug 2026 23:20:25 GMT, Alexander Matveev <[email protected]> wrote:
>> modules/javafx.media/src/main/java/javafx/scene/media/Media.java line 355: >> >>> 353: * <ul> >>> 354: * <li>The supplied URI must conform to RFC-2396 as required by >>> 355: * <a >>> href="https://docs.oracle.com/javase/8/docs/api/java/net/URI.html";>java.net.URI</a>.</li> >> >> why are we referencing java8 docs? >> shouldn't it be a relative ref? > > URI is not part of JavaFX, so we cannot use relative ref. Also, I found that > JavaFX docs a published in several places, so using something like > "../../URI.html" will not work. > > I can update Java 8 links to latest, but I am not sure what policy we have in > term of referencing old JDK releases and should we keep updating it to latest > docs with each release. For example JavaFX 27 will point to JDK 27 docs. Gradle is configured to generate Javadocs with links to the documentation for the supported JDK version. See: - https://github.com/openjdk/jfx/blob/f7948897401f1a83bf8b0597d1e9f101504ed89e/build.gradle#L402 - https://github.com/openjdk/jfx/blob/f7948897401f1a83bf8b0597d1e9f101504ed89e/build.properties#L90 Therefore, you should be able to replace: `<a href="https://docs.oracle.com/javase/8/docs/api/java/net/URI.html";>java.net.URI</a>` with: `{@link java.net.URI}` ------------- PR Review Comment: https://git.openjdk.org/jfx/pull/2251#discussion_r3734297240
