JDK-8289722 : Add reference or informations about DTDBuilder in Java Documentation
  • Type: Enhancement
  • Component: client-libs
  • Sub-Component: javax.swing
  • Affected Version: 19
  • Priority: P4
  • Status: Open
  • Resolution: Unresolved
  • OS: generic
  • CPU: generic
  • Submitted: 2022-07-04
  • Updated: 2022-08-08
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 :  
Description
A DESCRIPTION OF THE PROBLEM :
Javax Swing Html Parser is a driven DTD-HTML parser.

The aim of JDK-6190716 was to opensourced DTDBuilder.
https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6190716

This Done now but some Developers, including me, still was stuck when they wanted to alter the default DTD used with HTML classes, only because we ignored that such tool exists.

I suggest to add a reference or informations about DTDBuilder tool in the Java Documentation. For example, in the HTML Package Summary : https://docs.oracle.com/en/java/javase/18/docs/api/java.desktop/javax/swing/text/html/parser/package-summary.html

I can write such comments if you're interested.
I used DTDBuilder to produce an HTML+MathML DTD :
https://github.com/w3c/mathml-core/issues/51#issuecomment-823045966

This report follows a PR, I already send about a DTDBuilder's bug prevented its usage as indivudal tool :
https://github.com/openjdk/jdk/pull/3626



Comments
Additional Information from submitter: ============================ A draft proposition at https://github.com/scientificware/jdk/issues/5#issue-1293121811 https://github.com/openjdk/jdk/compare/master...scientificware:jdk:scientificware-JDK-8289741-ref-DTDBuilder
08-08-2022

Moving to JDK project for review.
05-07-2022