JDK-8284774 : Use headings and provide anchors in Document interface
  • Type: Bug
  • Component: client-libs
  • Sub-Component: javax.swing
  • Affected Version: 8
  • Priority: P4
  • Status: Open
  • Resolution: Unresolved
  • Submitted: 2022-04-12
  • Updated: 2022-04-15
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
tbdUnresolved
Related Reports
Relates :  
JDK-8220379 - Fix doclint handling of headings
Relates :  
JDK-8031082 - Fix non-missing doclint problems in client libraries
Relates :  
JDK-8235818 - Inline information from broken external links in java.desktop
Relates :  
JDK-8187399 - Different problems in the javadoc's links in java.desktop package
Relates :  
JDK-8220250 - fix headings in java.desktop
Relates :  
JDK-8284773 - Clarify spec for DefaultEditorKit.EndOfLineStringProperty
Description
Document interface has a long overview of Swing text architecture. The sections are marked with <b> in a regular <p> where they should be headings <h2> etc.

These headings should provide anchors for linking.
Comments
The usage of <code> can be updated to {@code }. In some cases, {@link } should be used to link to the class or method for easier navigation.
12-04-2022