src/java.xml/share/classes/javax/xml/validation/SchemaFactory.java

*** 204,214 ****
       *   </li>
       * </ol>
       *
       * <p>If everything fails, {@link IllegalArgumentException} will be thrown.
       *
!      * <p><strong>Tip for Trouble-shooting:</strong>
       * <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
       * URIs are properly escaped in it. For example:
       * <pre>
--- 204,214 ----
       *   </li>
       * </ol>
       *
       * <p>If everything fails, {@link IllegalArgumentException} will be thrown.
       *
!      * <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
       * URIs are properly escaped in it. For example:
       * <pre>
*** 257,267 ****
       * is returned if specified factory class name supports the specified schema language.
       * This function is useful when there are multiple providers in the classpath.
       * It gives more control to the application as it can specify which provider
       * should be loaded.
       *
!      * <h2>Tip for Trouble-shooting</h2>
       * <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.
       *
       * <p> If you have problems try:
--- 257,267 ----
       * is returned if specified factory class name supports the specified schema language.
       * This function is useful when there are multiple providers in the classpath.
       * It gives more control to the application as it can specify which provider
       * should be loaded.
       *
!      * <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.
       *
       * <p> If you have problems try:
*** 715,725 ****
       * abort the schema compilation and the same exception will be thrown from
       * this method. Also, after an error is reported to a handler, the callee is allowed
       * 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>
       * <p>
       * The resulting schema contains components from the specified sources.
       * The same result would be achieved if all these sources were
       * imported, using appropriate values for schemaLocation and namespace,
       * into a single schema document with a different targetNamespace
--- 715,725 ----
       * abort the schema compilation and the same exception will be thrown from
       * this method. Also, after an error is reported to a handler, the callee is allowed
       * 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.
       *
!      * <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
       * imported, using appropriate values for schemaLocation and namespace,
       * into a single schema document with a different targetNamespace
*** 735,745 ****
       * <p>
       * If the parsed set of schemas includes error(s) as
       * 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>
       *
       * <p>For RELAX NG, this method must throw {@link UnsupportedOperationException}
       * if {@code schemas.length!=1}.
       *
       *
--- 735,745 ----
       * <p>
       * If the parsed set of schemas includes error(s) as
       * specified in the section 5.1 of the XML Schema spec, then
       * the error must be reported to the {@link ErrorHandler}.
       *
!      * <h4>RELAX NG</h4>
       *
       * <p>For RELAX NG, this method must throw {@link UnsupportedOperationException}
       * if {@code schemas.length!=1}.
       *
       *
*** 795,805 ****
       * for {@link SchemaFactory} features to be inherited automatically.
       * Developers should
       * make sure that features, such as secure processing, are explicitly
       * set in both places.
       *
!      * <h2>W3C XML Schema 1.0</h2>
       * <p>
       * For XML Schema, this method creates a {@link Schema} object that
       * performs validation by using location hints specified in documents.
       *
       * <p>
--- 795,805 ----
       * for {@link SchemaFactory} features to be inherited automatically.
       * Developers should
       * make sure that features, such as secure processing, are explicitly
       * set in both places.
       *
!      * <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.
       *
       * <p>
*** 813,823 ****
       * <p>
       * Note that the use of schema location hints introduces a
       * vulnerability to denial-of-service attacks.
       *
       *
!      * <h2>RELAX NG</h2>
       * <p>
       * RELAX NG does not support this operation.
       *
       * @return
       *      Always return non-null valid {@link Schema} object.
--- 813,823 ----
       * <p>
       * Note that the use of schema location hints introduces a
       * vulnerability to denial-of-service attacks.
       *
       *
!      * <h4>RELAX NG</h4>
       * <p>
       * RELAX NG does not support this operation.
       *
       * @return
       *      Always return non-null valid {@link Schema} object.