8220254: fix headings in java.xml
authorjoehw
Fri, 29 Mar 2019 18:00:31 +0000
changeset 54342 07212a29787a
parent 54341 0b47455de59b
child 54343 6a1406c718ec
8220254: fix headings in java.xml Reviewed-by: lancea
src/java.xml/share/classes/com/sun/org/apache/xerces/internal/impl/xpath/regex/RegularExpression.java
src/java.xml/share/classes/javax/xml/catalog/CatalogFeatures.java
src/java.xml/share/classes/javax/xml/catalog/CatalogResolver.java
src/java.xml/share/classes/javax/xml/datatype/DatatypeFactory.java
src/java.xml/share/classes/javax/xml/parsers/DocumentBuilderFactory.java
src/java.xml/share/classes/javax/xml/parsers/SAXParserFactory.java
src/java.xml/share/classes/javax/xml/transform/TransformerFactory.java
src/java.xml/share/classes/javax/xml/validation/SchemaFactory.java
src/java.xml/share/classes/javax/xml/xpath/XPathFactory.java
--- a/src/java.xml/share/classes/com/sun/org/apache/xerces/internal/impl/xpath/regex/RegularExpression.java	Tue Mar 26 16:26:33 2019 +0100
+++ b/src/java.xml/share/classes/com/sun/org/apache/xerces/internal/impl/xpath/regex/RegularExpression.java	Fri Mar 29 18:00:31 2019 +0000
@@ -31,7 +31,7 @@
  * This engine does not conform to the POSIX regular expression.
  *
  * <hr width="50%">
- * <h3>How to use</h3>
+ * <h2>How to use</h2>
  *
  * <dl>
  *   <dt>A. Standard way
--- a/src/java.xml/share/classes/javax/xml/catalog/CatalogFeatures.java	Tue Mar 26 16:26:33 2019 +0100
+++ b/src/java.xml/share/classes/javax/xml/catalog/CatalogFeatures.java	Fri Mar 29 18:00:31 2019 +0000
@@ -164,7 +164,7 @@
  * set the property {@code javax.xml.catalog.defer} to false to allow the entire
  * catalog to be pre-loaded.
  *
- * <h3>Scope and Order</h3>
+ * <h2>Scope and Order</h2>
  * Features and properties can be set through the catalog file, the Catalog API,
  * system properties, and {@code jaxp.properties}, with a preference in the same order.
  * <p>
@@ -202,7 +202,7 @@
                         .build();
  * }</pre>
  *
- * <h3>JAXP XML Processor Support</h3>
+ * <h2>JAXP XML Processor Support</h2>
  * The Catalog Features are supported throughout the JAXP processors, including
  * SAX and DOM ({@link javax.xml.parsers}), and StAX parsers ({@link javax.xml.stream}),
  * Schema Validation ({@link javax.xml.validation}), and XML Transformation
@@ -246,7 +246,7 @@
  * The Catalog support is available for any process in the JAXP library that
  * supports a resolver. The following table lists all such processes.
  *
- * <h3><a id="ProcessesWithCatalogSupport">Processes with Catalog Support</a></h3>
+ * <h2><a id="ProcessesWithCatalogSupport">Processes with Catalog Support</a></h2>
  *
  * <table class="striped">
  * <caption>Processes with Catalog Support</caption>
--- a/src/java.xml/share/classes/javax/xml/catalog/CatalogResolver.java	Tue Mar 26 16:26:33 2019 +0100
+++ b/src/java.xml/share/classes/javax/xml/catalog/CatalogResolver.java	Fri Mar 29 18:00:31 2019 +0000
@@ -54,7 +54,7 @@
  * no further attempt will be made. Only if there is no match in the current
  * catalog, will alternate catalogs including delegate and next catalogs be considered.
  *
- * <h3>Search Order</h3>
+ * <h2>Search Order</h2>
  * The resolver will first search the system-type of entries with the specified
  * {@code systemId}. The system entries include {@code system},
  * {@code rewriteSystem} and {@code systemSuffix} entries.
@@ -75,7 +75,7 @@
  * with the specified {@code systemId} or {@code href}. The {@code uri} entries
  * include {@code uri}, {@code rewriteURI}, and {@code uriSuffix} entries.
  *
- * <h3>Error Handling</h3>
+ * <h2>Error Handling</h2>
  * The interfaces that the CatalogResolver extend specified checked exceptions, including:
  * <ul>
  * <li>
--- a/src/java.xml/share/classes/javax/xml/datatype/DatatypeFactory.java	Tue Mar 26 16:26:33 2019 +0100
+++ b/src/java.xml/share/classes/javax/xml/datatype/DatatypeFactory.java	Fri Mar 29 18:00:31 2019 +0000
@@ -183,7 +183,7 @@
      * it can use the factory to configure and obtain datatype instances.
      *
      *
-     * <h2>Tip for Trouble-shooting</h2>
+     * <h4>Tip for Trouble-shooting</h4>
      * <p>Setting the {@code jaxp.debug} system property will cause
      * this method to print a lot of debug messages
      * to {@code System.err} about what it is doing and where it is looking at.
--- a/src/java.xml/share/classes/javax/xml/parsers/DocumentBuilderFactory.java	Tue Mar 26 16:26:33 2019 +0100
+++ b/src/java.xml/share/classes/javax/xml/parsers/DocumentBuilderFactory.java	Fri Mar 29 18:00:31 2019 +0000
@@ -118,7 +118,7 @@
      * configure and obtain parser instances.
      *
      *
-     * <h2>Tip for Trouble-shooting</h2>
+     * <h4>Tip for Trouble-shooting</h4>
      * <p>
      * Setting the {@code jaxp.debug} system property will cause
      * this method to print a lot of debug messages
@@ -154,7 +154,7 @@
      * it can use the factory to configure and obtain parser instances.
      *
      *
-     * <h2>Tip for Trouble-shooting</h2>
+     * <h4>Tip for Trouble-shooting</h4>
      * <p>Setting the {@code jaxp.debug} system property will cause
      * this method to print a lot of debug messages
      * to {@code System.err} about what it is doing and where it is looking at.
@@ -549,7 +549,7 @@
      * exception when the {@link #newDocumentBuilder()} is invoked.
      *
      *
-     * <h3>Note for implementors</h3>
+     * <h4>Note for implementors</h4>
      *
      * <p>
      * A parser must be able to work with any {@link Schema}
--- a/src/java.xml/share/classes/javax/xml/parsers/SAXParserFactory.java	Tue Mar 26 16:26:33 2019 +0100
+++ b/src/java.xml/share/classes/javax/xml/parsers/SAXParserFactory.java	Fri Mar 29 18:00:31 2019 +0000
@@ -123,7 +123,7 @@
      *
      *
      *
-     * <h2>Tip for Trouble-shooting</h2>
+     * <h4>Tip for Trouble-shooting</h4>
      * <p>
      * Setting the {@code jaxp.debug} system property will cause
      * this method to print a lot of debug messages
@@ -161,7 +161,7 @@
      * it can use the factory to configure and obtain parser instances.
      *
      *
-     * <h2>Tip for Trouble-shooting</h2>
+     * <h4>Tip for Trouble-shooting</h4>
      * <p>Setting the {@code jaxp.debug} system property will cause
      * this method to print a lot of debug messages
      * to {@code System.err} about what it is doing and where it is looking at.
@@ -389,7 +389,7 @@
      * Such configuration will cause a {@link SAXException}
      * exception when those properties are set on a {@link SAXParser}.
      *
-     * <h3>Note for implementors</h3>
+     * <h4>Note for implementors</h4>
      * <p>
      * A parser must be able to work with any {@link Schema}
      * implementation. However, parsers and schemas are allowed
--- a/src/java.xml/share/classes/javax/xml/transform/TransformerFactory.java	Tue Mar 26 16:26:33 2019 +0100
+++ b/src/java.xml/share/classes/javax/xml/transform/TransformerFactory.java	Fri Mar 29 18:00:31 2019 +0000
@@ -140,7 +140,7 @@
      * {@code TransformerFactory} it can use the factory to configure
      * and obtain transformer instances.
      *
-     * <h2>Tip for Trouble-shooting</h2>
+     * <h4>Tip for Trouble-shooting</h4>
      * <p>Setting the {@code jaxp.debug} system property will cause
      * this method to print a lot of debug messages
      * to {@code System.err} about what it is doing and where it is looking at.
--- a/src/java.xml/share/classes/javax/xml/validation/SchemaFactory.java	Tue Mar 26 16:26:33 2019 +0100
+++ b/src/java.xml/share/classes/javax/xml/validation/SchemaFactory.java	Fri Mar 29 18:00:31 2019 +0000
@@ -206,7 +206,7 @@
      *
      * <p>If everything fails, {@link IllegalArgumentException} will be thrown.
      *
-     * <p><strong>Tip for Trouble-shooting:</strong>
+     * <h4>Tip for Trouble-shooting:</h4>
      * <p>See {@link java.util.Properties#load(java.io.InputStream)} for
      * exactly how a property file is parsed. In particular, colons ':'
      * need to be escaped in a property file, so make sure schema language
@@ -259,7 +259,7 @@
      * It gives more control to the application as it can specify which provider
      * should be loaded.
      *
-     * <h2>Tip for Trouble-shooting</h2>
+     * <h4>Tip for Trouble-shooting</h4>
      * <p>Setting the {@code jaxp.debug} system property will cause
      * this method to print a lot of debug messages
      * to {@code System.err} about what it is doing and where it is looking at.
@@ -717,7 +717,7 @@
      * to abort the further processing by throwing it. If an error handler is not set,
      * the callee will throw the first error it finds in the sources.
      *
-     * <h2>W3C XML Schema 1.0</h2>
+     * <h4>W3C XML Schema 1.0</h4>
      * <p>
      * The resulting schema contains components from the specified sources.
      * The same result would be achieved if all these sources were
@@ -737,7 +737,7 @@
      * specified in the section 5.1 of the XML Schema spec, then
      * the error must be reported to the {@link ErrorHandler}.
      *
-     * <h2>RELAX NG</h2>
+     * <h4>RELAX NG</h4>
      *
      * <p>For RELAX NG, this method must throw {@link UnsupportedOperationException}
      * if {@code schemas.length!=1}.
@@ -797,7 +797,7 @@
      * make sure that features, such as secure processing, are explicitly
      * set in both places.
      *
-     * <h2>W3C XML Schema 1.0</h2>
+     * <h4>W3C XML Schema 1.0</h4>
      * <p>
      * For XML Schema, this method creates a {@link Schema} object that
      * performs validation by using location hints specified in documents.
@@ -815,7 +815,7 @@
      * vulnerability to denial-of-service attacks.
      *
      *
-     * <h2>RELAX NG</h2>
+     * <h4>RELAX NG</h4>
      * <p>
      * RELAX NG does not support this operation.
      *
--- a/src/java.xml/share/classes/javax/xml/xpath/XPathFactory.java	Tue Mar 26 16:26:33 2019 +0100
+++ b/src/java.xml/share/classes/javax/xml/xpath/XPathFactory.java	Fri Mar 29 18:00:31 2019 +0000
@@ -239,7 +239,7 @@
      * should be loaded.</p>
      *
      *
-     * <h2>Tip for Trouble-shooting</h2>
+     * <h4>Tip for Trouble-shooting</h4>
      * <p>Setting the <code>jaxp.debug</code> system property will cause
      * this method to print a lot of debug messages
      * to <code>System.err</code> about what it is doing and where it is looking at.</p>