src/java.base/share/classes/java/util/spi/LocaleServiceProvider.java

rev 12979 : imported patch 8062006

*** 121,149 ****
   * <p>
   * Java Runtime Environment provides the following four locale providers:
   * <ul>
   * <li> "CLDR": A provider based on Unicode Consortium's
   * <a href="http://cldr.unicode.org/">CLDR Project</a>.
!  * <li> "JRE": represents the locale sensitive services that is compatible
!  * with the prior JDK releases (same with JDK8's "JRE").
   * <li> "SPI": represents the locale sensitive services implementing the subclasses of
   * this {@code LocaleServiceProvider} class.
   * <li> "HOST": A provider that reflects the user's custom settings in the
   * underlying operating system. This provider may not be available, depending
   * on the Java Runtime Environment implementation.
   * </ul>
   * <p>
   * For example, if the following is specified in the property:
   * <pre>
!  * java.locale.providers=SPI,CLDR,JRE
   * </pre>
   * the locale sensitive services in the SPI providers are looked up first. If the
   * desired locale sensitive service is not available, then the runtime looks for CLDR,
!  * JRE in that order.
   * <p>
!  * The default order for looking up the preferred locale providers is "CLDR,JRE",
!  * so specifying "CLDR,JRE" is identical to the default behavior. Applications which
   * require implementations of the locale sensitive services must explicitly specify
   * "SPI" in order for the Java runtime to load them from the classpath.
   *
   * @since        1.6
   */
--- 121,151 ----
   * <p>
   * Java Runtime Environment provides the following four locale providers:
   * <ul>
   * <li> "CLDR": A provider based on Unicode Consortium's
   * <a href="http://cldr.unicode.org/">CLDR Project</a>.
!  * <li> "COMPAT": represents the locale sensitive services that is compatible
!  * with the prior JDK releases up to JDK8 (same as JDK8's "JRE").
   * <li> "SPI": represents the locale sensitive services implementing the subclasses of
   * this {@code LocaleServiceProvider} class.
   * <li> "HOST": A provider that reflects the user's custom settings in the
   * underlying operating system. This provider may not be available, depending
   * on the Java Runtime Environment implementation.
+  * <li> "JRE": represents a synonym to "COMPAT". This name
+  * is deprecated and will be removed in the future release of JDK.
   * </ul>
   * <p>
   * For example, if the following is specified in the property:
   * <pre>
!  * java.locale.providers=SPI,CLDR,COMPAT
   * </pre>
   * the locale sensitive services in the SPI providers are looked up first. If the
   * desired locale sensitive service is not available, then the runtime looks for CLDR,
!  * COMPAT in that order.
   * <p>
!  * The default order for looking up the preferred locale providers is "CLDR,COMPAT",
!  * so specifying "CLDR,COMPAT" is identical to the default behavior. Applications which
   * require implementations of the locale sensitive services must explicitly specify
   * "SPI" in order for the Java runtime to load them from the classpath.
   *
   * @since        1.6
   */