ICU-9643 (J) Change "@internal ICU 50" display context API to "@draft ICU 51"

X-SVN-Rev: 32899

icu4j/main/classes/core/src/com/ibm/icu/text/DisplayContext.java

@@ -1,6 +1,6 @@
 /*
  *******************************************************************************
- * Copyright (C) 2012, International Business Machines Corporation and    *
+ * Copyright (C) 2012, International Business Machines Corporation and         *
  * others. All Rights Reserved.                                                *
  *******************************************************************************
  */
@@ -9,7 +9,8 @@ package com.ibm.icu.text;
 /**
  * Display context settings.
  * Note, the specific numeric values are internal and may change.
- * @internal ICU 50 technology preview
+ * @draft ICU 51
+ * @provisional This API might change or be removed in a future release.
  */
 public enum DisplayContext {
     /**
@@ -20,14 +21,16 @@ public enum DisplayContext {
      * A possible setting for DIALECT_HANDLING:
      * use standard names when generating a locale name,
      * e.g. en_GB displays as 'English (United Kingdom)'.
-     * @internal ICU 50 technology preview
+     * @draft ICU 51
+     * @provisional This API might change or be removed in a future release.
      */
     STANDARD_NAMES(Type.DIALECT_HANDLING, 0),
     /**
      * A possible setting for DIALECT_HANDLING:
      * use dialect names, when generating a locale name,
      * e.g. en_GB displays as 'British English'.
-     * @internal ICU 50 technology preview
+     * @draft ICU 51
+     * @provisional This API might change or be removed in a future release.
      */
     DIALECT_NAMES(Type.DIALECT_HANDLING, 1),
     /**
@@ -37,28 +40,32 @@ public enum DisplayContext {
     /**
      * A possible setting for CAPITALIZATION:
      * The capitalization context to be used is unknown (this is the default value).
-     * @internal ICU 50 technology preview
+     * @draft ICU 51
+     * @provisional This API might change or be removed in a future release.
      */
     CAPITALIZATION_NONE(Type.CAPITALIZATION, 0),
     /**
      * A possible setting for CAPITALIZATION:
      * The capitalization context if a date, date symbol or display name is to be
      * formatted with capitalization appropriate for the middle of a sentence.
-     * @internal ICU 50 technology preview
+     * @draft ICU 51
+     * @provisional This API might change or be removed in a future release.
      */
     CAPITALIZATION_FOR_MIDDLE_OF_SENTENCE(Type.CAPITALIZATION, 1),
     /**
      * A possible setting for CAPITALIZATION:
      * The capitalization context if a date, date symbol or display name is to be
      * formatted with capitalization appropriate for the beginning of a sentence.
-     * @internal ICU 50 technology preview
+     * @draft ICU 51
+     * @provisional This API might change or be removed in a future release.
      */
     CAPITALIZATION_FOR_BEGINNING_OF_SENTENCE(Type.CAPITALIZATION, 2),
     /**
      * A possible setting for CAPITALIZATION:
      * The capitalization context if a date, date symbol or display name is to be
      * formatted with capitalization appropriate for a user-interface list or menu item.
-     * @internal ICU 50 technology preview
+     * @draft ICU 51
+     * @provisional This API might change or be removed in a future release.
      */
     CAPITALIZATION_FOR_UI_LIST_OR_MENU(Type.CAPITALIZATION, 3),
     /**
@@ -66,24 +73,28 @@ public enum DisplayContext {
      * The capitalization context if a date, date symbol or display name is to be
      * formatted with capitalization appropriate for stand-alone usage such as an
      * isolated name on a calendar page.
-     * @internal ICU 50 technology preview
+     * @draft ICU 51
+     * @provisional This API might change or be removed in a future release.
      */
     CAPITALIZATION_FOR_STANDALONE(Type.CAPITALIZATION, 4);
 
     /**
      * Type values for DisplayContext
-     * @internal ICU 50 technology preview
+     * @draft ICU 51
+     * @provisional This API might change or be removed in a future release.
      */
     public enum Type {
         /**
          * DIALECT_HANDLING can be set to STANDARD_NAMES or DIALECT_NAMES.
-         * @internal ICU 50 technology preview
+         * @draft ICU 51
+         * @provisional This API might change or be removed in a future release.
          */
         DIALECT_HANDLING,
         /**
          * CAPITALIZATION can be set to one of CAPITALIZATION_NONE through
          * CAPITALIZATION_FOR_STANDALONE.
-         * @internal ICU 50 technology preview
+         * @draft ICU 51
+         * @provisional This API might change or be removed in a future release.
          */
         CAPITALIZATION
     }
@@ -97,7 +108,8 @@ public enum DisplayContext {
     /**
      * Get the Type part of the enum item
      * (e.g. CAPITALIZATION)
-     * @internal ICU 50 technology preview
+     * @draft ICU 51
+     * @provisional This API might change or be removed in a future release.
      */
     public Type type() {
         return type;
@@ -105,7 +117,8 @@ public enum DisplayContext {
     /**
      * Get the value part of the enum item
      * (e.g. CAPITALIZATION_FOR_STANDALONE)
-     * @internal ICU 50 technology preview
+     * @draft ICU 51
+     * @provisional This API might change or be removed in a future release.
      */
     public int value() {
         return value;

icu4j/main/classes/core/src/com/ibm/icu/text/LocaleDisplayNames.java

@@ -68,7 +68,8 @@ public abstract class LocaleDisplayNames {
      * @param contexts one or more context settings (e.g. for dialect
      *              handling, capitalization, etc.
      * @return a LocaleDisplayNames instance
-     * @internal ICU 50 technology preview
+     * @draft ICU 51
+     * @provisional This API might change or be removed in a future release.
      */
     public static LocaleDisplayNames getInstance(ULocale locale, DisplayContext... contexts) {
         return LocaleDisplayNamesImpl.getInstance(locale, contexts);
@@ -94,7 +95,8 @@ public abstract class LocaleDisplayNames {
      * Returns the current value for a specified DisplayContext.Type.
      * @param type the DisplayContext.Type whose value to return
      * @return the current DisplayContext setting for the specified type
-     * @internal ICU 50 technology preview
+     * @draft ICU 51
+     * @provisional This API might change or be removed in a future release.
      */
     public abstract DisplayContext getContext(DisplayContext.Type type);
 

icu4j/main/classes/core/src/com/ibm/icu/text/SimpleDateFormat.java

@@ -2631,7 +2631,8 @@ public class SimpleDateFormat extends DateFormat {
      * such as CAPITALIZATION_FOR_STANDALONE. 
      * 
      * @param context The DisplayContext value to set. 
-     * @internal ICU 50 technology preview
+     * @draft ICU 51
+     * @provisional This API might change or be removed in a future release.
      */
     public void setContext(DisplayContext context) {
         if (context.type() == DisplayContext.Type.CAPITALIZATION) {
@@ -2645,7 +2646,8 @@ public class SimpleDateFormat extends DateFormat {
      * 
      * @param type the DisplayContext.Type whose value to return
      * @return the current DisplayContext setting for the specified type
-     * @internal ICU 50 technology preview
+     * @draft ICU 51
+     * @provisional This API might change or be removed in a future release.
      */
     public DisplayContext getContext(DisplayContext.Type type) {
         return (type == DisplayContext.Type.CAPITALIZATION && capitalizationSetting != null)?