Details

      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



      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>
         ^

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                joehw Joe Wang
                Reporter:
                jjg Jonathan Gibbons
              • Votes:
                0 Vote for this issue
                Watchers:
                2 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: