Mercurial > hg > openjdk > jdk9 > jaxws

changeset 670:68e3599c33c1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
8149923: invalid javadoc in javax.xml.bind.JAXBContext (introduced by 8138699) Reviewed-by: lancea
author mkos
date Thu, 18 Feb 2016 10:20:56 +0100
parents c072c572d149
children fafd694e801f
files src/java.xml.bind/share/classes/javax/xml/bind/JAXBContext.java
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 11 16:06:02 2016 -0800
+++ b/src/java.xml.bind/share/classes/javax/xml/bind/JAXBContext.java	Thu Feb 18 10:20:56 2016 +0100
@@ -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,