changeset 671:fafd694e801f jdk-9+107

Merge
author lana
date Thu, 18 Feb 2016 13:41:52 -0800
parents 5b2915815dcb (current diff) 68e3599c33c1 (diff)
children 513eb2e432f6
files
diffstat 1 files changed, 8 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/src/java.xml.bind/share/classes/javax/xml/bind/JAXBContext.java	Thu Feb 18 11:30:15 2016 -0800
+++ b/src/java.xml.bind/share/classes/javax/xml/bind/JAXBContext.java	Thu Feb 18 13:41:52 2016 -0800
@@ -450,8 +450,14 @@
      *      in an empty map.
      *
      * @return a new instance of a {@code JAXBContext}
-     * @throws JAXBException if an error was encountered while creating the
-     *                       {@code JAXBContext}. See {@link #newInstance(String, ClassLoader)} for details.
+     * @throws JAXBException
+     *      if an error was encountered while creating the {@code JAXBContext} such as
+     * <ol>
+     *   <li>failure to locate either ObjectFactory.class or jaxb.index in the packages</li>
+     *   <li>an ambiguity among global elements contained in the contextPath</li>
+     *   <li>failure to locate a value for the context factory provider property</li>
+     *   <li>mixing schema derived packages from different providers on the same contextPath</li>
+     * </ol>
      * @since 1.6, JAXB 2.0
      */
     public static JAXBContext newInstance( String contextPath,