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



open/src/java.xml/share/classes/javax/xml/xpath/XPathFactory.java:242: Note: low heading <h2>
     * <h2>Tip for Trouble-shooting</h2>
       ^
open/src/java.xml/share/classes/javax/xml/parsers/SAXParserFactory.java:126: Note: low heading <h2>
     * <h2>Tip for Trouble-shooting</h2>
       ^
open/src/java.xml/share/classes/javax/xml/parsers/SAXParserFactory.java:164: Note: low heading <h2>
     * <h2>Tip for Trouble-shooting</h2>
       ^
open/src/java.xml/share/classes/javax/xml/parsers/SAXParserFactory.java:392: Note: low heading <h3>
     * <h3>Note for implementors</h3>
       ^
open/src/java.xml/share/classes/javax/xml/parsers/DocumentBuilderFactory.java:121: Note: low heading <h2>
     * <h2>Tip for Trouble-shooting</h2>
       ^
open/src/java.xml/share/classes/javax/xml/parsers/DocumentBuilderFactory.java:157: Note: low heading <h2>
     * <h2>Tip for Trouble-shooting</h2>
       ^
open/src/java.xml/share/classes/javax/xml/parsers/DocumentBuilderFactory.java:552: Note: low heading <h3>
     * <h3>Note for implementors</h3>
       ^
open/src/java.xml/share/classes/javax/xml/validation/SchemaFactory.java:262: Note: low heading <h2>
     * <h2>Tip for Trouble-shooting</h2>
       ^
open/src/java.xml/share/classes/javax/xml/validation/SchemaFactory.java:720: Note: low heading <h2>
     * <h2>W3C XML Schema 1.0</h2>
       ^
open/src/java.xml/share/classes/javax/xml/validation/SchemaFactory.java:740: Note: low heading <h2>
     * <h2>RELAX NG</h2>
       ^
open/src/java.xml/share/classes/javax/xml/validation/SchemaFactory.java:800: Note: low heading <h2>
     * <h2>W3C XML Schema 1.0</h2>
       ^
open/src/java.xml/share/classes/javax/xml/validation/SchemaFactory.java:818: Note: low heading <h2>
     * <h2>RELAX NG</h2>
       ^
open/src/java.xml/share/classes/javax/xml/transform/TransformerFactory.java:143: Note: low heading <h2>
     * <h2>Tip for Trouble-shooting</h2>
       ^
open/src/java.xml/share/classes/javax/xml/datatype/DatatypeFactory.java:186: Note: low heading <h2>
     * <h2>Tip for Trouble-shooting</h2>
       ^
open/src/java.xml/share/classes/javax/xml/catalog/CatalogResolver.java:57: Note: missing heading <h2>
 * <h3>Search Order</h3>
   ^
open/src/java.xml/share/classes/javax/xml/catalog/CatalogFeatures.java:167: Note: missing heading <h2>
 * <h3>Scope and Order</h3>
   ^
open/src/java.xml/share/classes/com/sun/org/apache/xerces/internal/impl/xpath/regex/RegularExpression.java:34: Note: missing heading <h2>
 * <h3>How to use</h3>
   ^