src/java.xml.bind/share/classes/javax/xml/bind/JAXBContextFactory.java

*** 36,46 ****
   */
  public interface JAXBContextFactory {
  
      /**
       * <p>
!      * Create a new instance of a <tt>JAXBContext</tt> class.
       *
       * <p>
       * For semantics see {@link javax.xml.bind.JAXBContext#newInstance(Class[], java.util.Map)}
       *
       * @param classesToBeBound
--- 36,46 ----
   */
  public interface JAXBContextFactory {
  
      /**
       * <p>
!      * Create a new instance of a {@code JAXBContext} class.
       *
       * <p>
       * For semantics see {@link javax.xml.bind.JAXBContext#newInstance(Class[], java.util.Map)}
       *
       * @param classesToBeBound
*** 50,64 ****
       * @param properties
       *      provider-specific properties. Can be null, which means the same thing as passing
       *      in an empty map.
       *
       * @return
!      *      A new instance of a <tt>JAXBContext</tt>.
       *
       * @throws JAXBException
       *      if an error was encountered while creating the
!      *      <tt>JAXBContext</tt>, such as (but not limited to):
       * <ol>
       *  <li>Classes use JAXB annotations incorrectly
       *  <li>Classes have colliding annotations (i.e., two classes with the same type name)
       *  <li>The JAXB implementation was unable to locate
       *      provider-specific out-of-band information (such as additional
--- 50,64 ----
       * @param properties
       *      provider-specific properties. Can be null, which means the same thing as passing
       *      in an empty map.
       *
       * @return
!      *      A new instance of a {@code JAXBContext}.
       *
       * @throws JAXBException
       *      if an error was encountered while creating the
!      *      {@code JAXBContext}, such as (but not limited to):
       * <ol>
       *  <li>Classes use JAXB annotations incorrectly
       *  <li>Classes have colliding annotations (i.e., two classes with the same type name)
       *  <li>The JAXB implementation was unable to locate
       *      provider-specific out-of-band information (such as additional
*** 73,101 ****
      JAXBContext createContext(Class<?>[] classesToBeBound,
                                Map<String, ?> properties ) throws JAXBException;
  
      /**
       * <p>
!      * Create a new instance of a <tt>JAXBContext</tt> class.
       *
       * <p>
       * For semantics see {@link javax.xml.bind.JAXBContext#newInstance(String, ClassLoader, java.util.Map)}
       *
       * <p>
       * The interpretation of properties is up to implementations. Implementations should
!      * throw <tt>JAXBException</tt> if it finds properties that it doesn't understand.
       *
       * @param contextPath list of java package names that contain schema derived classes
       * @param classLoader
       *      This class loader will be used to locate the implementation classes.
       * @param properties
       *      provider-specific properties. Can be null, which means the same thing as passing
       *      in an empty map.
       *
!      * @return a new instance of a <tt>JAXBContext</tt>
       * @throws JAXBException if an error was encountered while creating the
!      *                       <tt>JAXBContext</tt> 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>
--- 73,101 ----
      JAXBContext createContext(Class<?>[] classesToBeBound,
                                Map<String, ?> properties ) throws JAXBException;
  
      /**
       * <p>
!      * Create a new instance of a {@code JAXBContext} class.
       *
       * <p>
       * For semantics see {@link javax.xml.bind.JAXBContext#newInstance(String, ClassLoader, java.util.Map)}
       *
       * <p>
       * The interpretation of properties is up to implementations. Implementations should
!      * throw {@code JAXBException} if it finds properties that it doesn't understand.
       *
       * @param contextPath list of java package names that contain schema derived classes
       * @param classLoader
       *      This class loader will be used to locate the implementation classes.
       * @param properties
       *      provider-specific properties. Can be null, which means the same thing as passing
       *      in an empty map.
       *
!      * @return a new instance of a {@code JAXBContext}
       * @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>