JDK-8220248 : fix headings in java.util.concurrent
  • Type: Bug
  • Component: core-libs
  • Sub-Component: java.util.concurrent
  • Affected Version: 13
  • Priority: P3
  • Status: Closed
  • Resolution: Fixed
  • Submitted: 2019-03-06
  • Updated: 2019-06-27
  • Resolved: 2019-05-02
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 b20Fixed
Related Reports
Relates :  
Description
The following issues are reported regarding headings in documentation comments.
For a general background information, see this message to jdk-dev@ojn.
   https://mail.openjdk.java.net/pipermail/jdk-dev/2019-March/002671.html

In the following messages ...

"missing heading" means that a heading is more than one greater than the 
previous heading or the generated heading that precedes this text in the 
generated page.. To fix this, lower the rank in the  heading tag. 
(e.g. change <h3> to <h2>).

"low" heading means that a heading is less than or equal to the generated
heading that precedes this text on the generated page. To fix this, increase
the rank in the heading tag. (e.g. change <h1> to <h2> or <h4> depeding on
the context.)

open/src/java.base/share/classes/java/util/concurrent/ExecutorService.java:69: Note: missing heading <h2>
 * <h3>Usage Examples</h3>
   ^
open/src/java.base/share/classes/java/util/concurrent/locks/Condition.java:141: Note: missing heading <h2>
 * <h3>Implementation Considerations</h3>
   ^
open/src/java.base/share/classes/java/util/concurrent/locks/Lock.java:120: Note: missing heading <h2>
 * <h3>Memory Synchronization</h3>
   ^
open/src/java.base/share/classes/java/util/concurrent/locks/AbstractQueuedSynchronizer.java:107: Note: missing heading <h2>
 * <h3>Usage</h3>
   ^
open/src/java.base/share/classes/java/util/concurrent/locks/ReentrantReadWriteLock.java:207: Note: missing heading <h2>
 * <h3>Implementation Notes</h3>
   ^
open/src/java.base/share/classes/java/util/concurrent/ScheduledExecutorService.java:68: Note: missing heading <h2>
 * <h3>Usage Example</h3>
Comments
https://cr.openjdk.java.net/~martin/webrevs/jdk/jsr166-integration/h3/index.html
07-03-2019