as per discussion on the jira issue XERCESJ-1687, updating the XML Sc…

…hema documentation git-svn-id: https://svn.apache.org/repos/asf/xerces/java/trunk@1821882 13f79535-47bb-0310-9956-ffa450edef68
apache · Jan 22, 2018 · a3a260f · a3a260f
1 parent f01205b
commit a3a260f
Showing 1 changed file with 8 additions and 0 deletions.
diff --git a/docs/xml-schema.xml b/docs/xml-schema.xml
@@ -130,6 +130,14 @@
             Javadoc for javax.xml.XMLConstants.FEATURE_SECURE_PROCESSING for
             more details.
             </li>
+            <li> The JAXP class javax.xml.validation.Schema is defined to be thread safe, i.e.
+            applications are encouraged to share it across many threads. There are few cases
+            observed while doing XML Schema 1.1 validation, where the thread safe definition
+            of javax.xml.validation.Schema is not honored. This problem is observed, while
+            using the XSD 1.1 syntax &lt;assert&gt; in the XSD documents. But there are also, various
+            cases observed while using XSD 1.1 syntax &lt;assert&gt;, when thread safety of javax.xml.validation.Schema
+            is honored correctly.
+            </li>
         </ul>
     </s2>
     <s2 title="Other Notes">