JDK-8209358 : Broken links in API docs for css page, fxml page, and all image files
  • Type: Bug
  • Component: javafx
  • Sub-Component: build
  • Affected Version: openjfx11
  • Priority: P2
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2018-08-10
  • Updated: 2018-08-13
  • Resolved: 2018-08-10
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
Other
openjfx11Fixed
Related Reports
Relates :  
JDK-8195795 - Organize output files by module/package, not just package
Description
The links to the css page, the fxml page, and all image files are broken in the FX 11 API docs. To see this, go to the following page:

https://download.java.net/java/early_access/openjfx11/docs/api/javafx.fxml/javafx/fxml/package-summary.html

and click on the "Introduction to FXML" link. You will get a 404.

The following is an example of missing images:

https://download.java.net/java/early_access/openjfx11/docs/api/javafx.graphics/javafx/scene/effect/SepiaTone.html

Instead of a pair of images, you see the text "A photo" and "The visual effect of SepiaTone on photo".
Comments
Changeset: e174f0b0fb51 Author: kcr Date: 2018-08-10 15:02 -0700 URL: http://hg.openjdk.java.net/openjfx/11-dev/rt/rev/e174f0b0fb51 8209358: Broken links in API docs for css page, fxml page, and all image files Reviewed-by: prr
10-08-2018
+1 -phil
10-08-2018
Webrev: http://cr.openjdk.java.net/~kcr/8209358/webrev/ Fix is as noted above.
10-08-2018
Evaluation: We use JDK 11 as a boot JDK to build FX 11. In JDK 11, the javadoc tool changed the layout of the API docs to organize the docs by module and then by package. Previously the docs we organized by package only. The 'gradle javadoc' task copies the resources into the generated API docs tree assuming the old hierarchy, leaving you with broken links in the docs. Solution: add the module name to the destination directory path. For compatibility in case someone is still using JDK 10 to build OpenJFX 11, we might make this conditional on !jdkVersion.startsWith("10")
10-08-2018