JDK-8233338 : FX javadoc headings are out of sequence
  • Type: Bug
  • Component: javafx
  • Sub-Component: other
  • Affected Version: openjfx14
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2019-10-31
  • Updated: 2019-11-13
  • Resolved: 2019-11-13
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
openjfx14Fixed
Related Reports
Blocks :  
JDK-8232064 - Switch FX build to use JDK 13.0.1 as boot JDK
Relates :  
JDK-8220379 - Fix doclint handling of headings
Relates :  
JDK-8219801 - Pages do not have

Description
With the changes in  JDK-8219801 and JDK-8220379 in the JDK 13 javadoc tool, all HTML heading tags in class documents must start with <h2> and be nested correctly (i.e., no skipping levels). We have a few places where we are using <h1> tags and several more where we are using <h3>. As a result, the build of FX docs via `gradle javadoc` fails with JDK 13.

This needs to be done before we upgrade our boot JDK to 13 as part of JDK-8232064, since the JDK 13 javadoc tool will enforce this restriction. The changes are compatible with older JDK versions (e.g., 11 or 12) so this should be done before we do the upgrade of the boot JDK.
Comments
Changeset: d46dcae7 Author: Kevin Rushforth <kcr@openjdk.org> Date: 2019-11-13 13:40:05 +0000 URL: https://git.openjdk.java.net/jfx/commit/d46dcae7 8233338: FX javadoc headings are out of sequence Reviewed-by: aghaisas
13-11-2019
Review: https://github.com/openjdk/jfx/pull/29
02-11-2019