JDK-8219801 : Pages do not have

  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 13
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2019-02-27
  • Updated: 2019-10-31
  • Resolved: 2019-03-04
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.
JDK 13
13 b11Fixed
Related Reports
Duplicate :  
Duplicate :  
Relates :  
Relates :  
Relates :  
Description
This is a repeat of JDK-8215307, which is to fix the headings in generated pages to start at <h1>.  The previous fix failed because of a bug in the test and a dependence on the order of iterating the contents of a directory on some systems. The previous fix was backed out with JDK-8219558.

After fixing the test to behave consistently on all platforms, two additional issues were identified, which caused the tests to fail on some platforms. The single- and split- index pages still had no <h1>, and neither did the index file written by AbstractPackageIndexWriter in some cases.

The fix for the single- and split- index pages was to just add the heading, although that did require minor local restructuring of the code.  The fix for AbstractPackageIndexWriter was to copy the equivalent code already written for AbstractModuleIndexWriter.

The fix for the test was simply to reset the current heading "level" when beginning to read each new file. (Previously, it was not reset when beginning to read the file, and so was left at the last value seen in the previous file.) The term is now renamed to "rank" in accordance with W3C terminology