ICU-8429 Degrade Region API status which did not get official final approval.

X-SVN-Rev: 30110

diff --git a/icu4j/APIChangeReport.html b/icu4j/APIChangeReport.html
index b1d49c250b2187d445ccc10d133e8797d05ccaa7..c122f855ff1243217b07fbcb023ef7caecd123c3 100644 (file)
--- a/icu4j/APIChangeReport.html
+++ b/icu4j/APIChangeReport.html
@@ -191,8 +191,6 @@ UnicodeSet
 <li>(draft)      public static final class <i>CharsTrie.State</i></li>
 <li>(draft)      public final class <i>CharsTrieBuilder</i></li>
 <li>(draft)      public class <i>Output</i></li>
-<li>(draft)      public class <i>Region</i></li>
-<li>(draft)      public static final class <i>Region.RegionType</i></li>
 <li>(draft)      public abstract class <i>StringTrieBuilder</i></li>
 <li>(draft)      public static final class <i>StringTrieBuilder.Option</i></li>
 <li>(draft)      public static final class <i>TimeZone.SystemTimeZoneType</i></li>
@@ -205,6 +203,6 @@ TimeZone
 </ul>
 
 <hr/>
-<p><i><font size="-1">Contents generated by ReportAPI tool on Tue May 10 22:34:15 EDT 2011<br/>Copyright (C) 2011, International Business Machines Corporation, All Rights Reserved.</font></i></p>
+<p><i><font size="-1">Contents generated by ReportAPI tool on Fri May 13 12:38:20 EDT 2011<br/>Copyright (C) 2011, International Business Machines Corporation, All Rights Reserved.</font></i></p>
 </body>
 </html>

diff --git a/icu4j/main/classes/core/src/com/ibm/icu/util/Region.java b/icu4j/main/classes/core/src/com/ibm/icu/util/Region.java
index baeb48275527a8a3e6a8d6bd80b455c11ac13bf6..ba2c330d58789eabb14800079f63bf3266dcf6fd 100644 (file)
--- a/icu4j/main/classes/core/src/com/ibm/icu/util/Region.java
+++ b/icu4j/main/classes/core/src/com/ibm/icu/util/Region.java
@@ -54,8 +54,8 @@ import com.ibm.icu.impl.ICUResourceBundle;
  *  ( WORLD, CONTINENT, or SUBCONTINENT ) will always be the containing region instead.
  *  
  * @author       John Emmons
- * @draft ICU 4.8
- * @provisional This API might change or be removed in a future release. 
+ * @internal ICU 4.8 technology preview
+ * @deprecated This API might change or be removed in a future release. 
  */
 
 public class Region implements Comparable<Region> {
@@ -64,55 +64,55 @@ public class Region implements Comparable<Region> {
      * RegionType is an enumeration defining the different types of regions.  Current possible
      * values are WORLD, CONTINENT, SUBCONTINENT, TERRITORY, GROUPING, DEPRECATED, and UNKNOWN.
      * 
-     * @draft ICU 4.8
-     * @provisional This API might change or be removed in a future release. 
+     * @internal ICU 4.8 technology preview
+     * @deprecated This API might change or be removed in a future release.
      */
 
     public enum RegionType {
         /**
          * Type representing the unknown region.
-         * @draft ICU 4.8
-         * @provisional This API might change or be removed in a future release. 
+         * @internal ICU 4.8 technology preview
+         * @deprecated This API might change or be removed in a future release.
          */
         UNKNOWN,
 
         /**
          * Type representing a territory.
-         * @draft ICU 4.8
-         * @provisional This API might change or be removed in a future release. 
+         * @internal ICU 4.8 technology preview
+         * @deprecated This API might change or be removed in a future release.
          */
         TERRITORY,
 
         /**
          * Type representing the whole world.
-         * @draft ICU 4.8
-         * @provisional This API might change or be removed in a future release. 
+         * @internal ICU 4.8 technology preview
+         * @deprecated This API might change or be removed in a future release.
          */
         WORLD,
         /**
          * Type representing a continent.
-         * @draft ICU 4.8
-         * @provisional This API might change or be removed in a future release. 
+         * @internal ICU 4.8 technology preview
+         * @deprecated This API might change or be removed in a future release.
          */
         CONTINENT,
         /**
          * Type representing a sub-continent.
-         * @draft ICU 4.8
-         * @provisional This API might change or be removed in a future release. 
+         * @internal ICU 4.8 technology preview
+         * @deprecated This API might change or be removed in a future release.
          */
         SUBCONTINENT,
         /**
          * Type representing a grouping of territories that is not to be used in
          * the normal WORLD/CONTINENT/SUBCONTINENT/TERRITORY containment tree.
-         * @draft ICU 4.8
-         * @provisional This API might change or be removed in a future release. 
+         * @internal ICU 4.8 technology preview
+         * @deprecated This API might change or be removed in a future release.
          */
         GROUPING,
         /**
          * Type representing a region whose code has been deprecated, usually
          * due to a country splitting into multiple territories or changing its name.
-         * @draft ICU 4.8
-         * @provisional This API might change or be removed in a future release. 
+         * @internal ICU 4.8 technology preview
+         * @deprecated This API might change or be removed in a future release.
          */
         DEPRECATED,
     }
@@ -120,8 +120,8 @@ public class Region implements Comparable<Region> {
     /**
      * A constant used for unknown numeric region code.
      * @see #getNumericCode()
-     * @draft ICU 4.8
-     * @provisional This API might change or be removed in a future release.
+     * @internal ICU 4.8 technology preview
+     * @deprecated This API might change or be removed in a future release.
      */
     public static final int UNDEFINED_NUMERIC_CODE = -1;
 
@@ -332,8 +332,8 @@ public class Region implements Comparable<Region> {
      * @return The corresponding region.
      * @throws NullPointerException if the supplied id is null.
      * @throws IllegalArgumentException if the supplied ID cannot be canonicalized to a Region ID that is known by ICU.
-     * @draft ICU 4.8
-     * @provisional This API might change or be removed in a future release. 
+     * @internal ICU 4.8 technology preview
+     * @deprecated This API might change or be removed in a future release.
      */
     
     public static Region get(String id) {
@@ -353,8 +353,8 @@ public class Region implements Comparable<Region> {
      * @param code The numeric code of the region to be retrieved.
      * @return The corresponding region.
      * @throws IllegalArgumentException if the supplied numeric code is not recognized.
-     * @draft ICU 4.8
-     * @provisional This API might change or be removed in a future release. 
+     * @internal ICU 4.8 technology preview
+     * @deprecated This API might change or be removed in a future release.
      */
 
     public static Region get(int code) {
@@ -376,8 +376,8 @@ public class Region implements Comparable<Region> {
      * @param id The string representing the region code to be canonicalized.
      * @return The canonicalized (preferred) form of the region code.  If the supplied region
      *         code is not recognized, the unknown region ( code "ZZ" ) is returned.
-     * @draft ICU 4.8
-     * @provisional This API might change or be removed in a future release. 
+     * @internal ICU 4.8 technology preview
+     * @deprecated This API might change or be removed in a future release.
      */
 
     public static String canonicalize(String id) {
@@ -396,8 +396,8 @@ public class Region implements Comparable<Region> {
      * 
      * @param id The string representing the region code to be checked.
      * @return TRUE if the supplied region code is canonical, FALSE otherwise.
-     * @draft ICU 4.8
-     * @provisional This API might change or be removed in a future release. 
+     * @internal ICU 4.8 technology preview
+     * @deprecated This API might change or be removed in a future release.
      */
    
     public static boolean isCanonical(String id) {
@@ -409,8 +409,8 @@ public class Region implements Comparable<Region> {
      * 
      * @param type The type of regions to be returned ( TERRITORY, MACROREGION, etc. )
      * @return An unmodifiable set of all known regions that match the given type.
-     * @draft ICU 4.8
-     * @provisional This API might change or be removed in a future release. 
+     * @internal ICU 4.8 technology preview
+     * @deprecated This API might change or be removed in a future release.
      */
 
     public static Set<Region> getAvailable(RegionType type) {
@@ -433,8 +433,8 @@ public class Region implements Comparable<Region> {
      * @return The region that geographically contains this region.  Returns NULL if this region is
      *  code "001" (World) or "ZZ" (Unknown region).  For example, calling this method with region "IT" (Italy)
      *  returns the region "039" (Southern Europe).    
-     * @draft ICU 4.8
-     * @provisional This API might change or be removed in a future release. 
+     * @internal ICU 4.8 technology preview
+     * @deprecated This API might change or be removed in a future release.
      */
 
     public Region getContainingRegion() {
@@ -458,8 +458,8 @@ public class Region implements Comparable<Region> {
      * the various sub regions of Europe - "039" (Southern Europe) - "151" (Eastern Europe) 
      * - "154" (Northern Europe) and "155" (Western Europe).
      *
-     * @draft ICU 4.8
-     * @provisional This API might change or be removed in a future release. 
+     * @internal ICU 4.8 technology preview
+     * @deprecated This API might change or be removed in a future release.
      */
 
     public Set<Region> getSubRegions() {
@@ -482,8 +482,8 @@ public class Region implements Comparable<Region> {
      *  For example, calling this method with region "150" (Europe) returns a set containing all
      *  the territories in Europe ( "FR" (France) - "IT" (Italy) - "DE" (Germany) etc. )
      *
-     * @draft ICU 4.8
-     * @provisional This API might change or be removed in a future release. 
+     * @internal ICU 4.8 technology preview
+     * @deprecated This API might change or be removed in a future release.
      */
     
     public Set<Region> getContainedTerritories() {
@@ -506,8 +506,8 @@ public class Region implements Comparable<Region> {
      * 
      * @return The string representation of this region, which is its canonical ID.
      *
-     * @draft ICU 4.8
-     * @provisional This API might change or be removed in a future release. 
+     * @internal ICU 4.8 technology preview
+     * @deprecated This API might change or be removed in a future release.
      */
  
     public String toString() {
@@ -520,8 +520,8 @@ public class Region implements Comparable<Region> {
      * given region does not have a numeric code assigned to it.  This is a very rare case and
      * only occurs for a few very small territories.
      *
-     * @draft ICU 4.8
-     * @provisional This API might change or be removed in a future release. 
+     * @internal ICU 4.8 technology preview
+     * @deprecated This API might change or be removed in a future release.
      */
    
     public int getNumericCode() {
@@ -532,8 +532,8 @@ public class Region implements Comparable<Region> {
      * 
      * @return This region's type classification, such as MACROREGION or TERRITORY.
      *
-     * @draft ICU 4.8
-     * @provisional This API might change or be removed in a future release. 
+     * @internal ICU 4.8 technology preview
+     * @deprecated This API might change or be removed in a future release.
      */
   
     public RegionType getType() {
@@ -544,8 +544,8 @@ public class Region implements Comparable<Region> {
      * 
      * @return Returns TRUE if this region matches the supplied type.
      *
-     * @draft ICU 4.8
-     * @provisional This API might change or be removed in a future release. 
+     * @internal ICU 4.8 technology preview
+     * @deprecated This API might change or be removed in a future release.
      */
   
     public boolean isOfType(RegionType type) {
@@ -554,8 +554,8 @@ public class Region implements Comparable<Region> {
 
     /**
      * {@inheritDoc}
-     * @draft ICU 4.8
-     * @provisional This API might change or be removed in a future release.
+     * @internal ICU 4.8 technology preview
+     * @deprecated This API might change or be removed in a future release.
      */
     public int compareTo(Region other) {
         return id.compareTo(other.id);