From: Markus Scherer <markus.icu@gmail.com>
Date: Fri, 29 Aug 2014 20:13:32 +0000 (+0000)
Subject: ICU-10946 clarify UScript.getName() & UScript.getShortName()
X-Git-Tag: milestone-59-0-1~1666
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=028ed85d32fe934712bf4748be65133214ca551f;p=icu

ICU-10946 clarify UScript.getName() & UScript.getShortName()

X-SVN-Rev: 36291
---

diff --git a/icu4j/main/classes/core/src/com/ibm/icu/lang/UScript.java b/icu4j/main/classes/core/src/com/ibm/icu/lang/UScript.java
index dc75e556e78..0569f717408 100644
--- a/icu4j/main/classes/core/src/com/ibm/icu/lang/UScript.java
+++ b/icu4j/main/classes/core/src/com/ibm/icu/lang/UScript.java
@@ -1169,10 +1169,13 @@ public final class UScript {
     }
 
     /**
-     * Gets a script name associated with the given script code.
-     * Returns  "Malayam" given MALAYAM
+     * Returns the long Unicode script name, if there is one.
+     * Otherwise returns the 4-letter ISO 15924 script code.
+     * Returns "Malayam" given MALAYALAM.
+     *
      * @param scriptCode int script code
-     * @return script name as a string in full as given in TR#24
+     * @return long script name as given in PropertyValueAliases.txt, or the 4-letter code
+     * @throws IllegalArgumentException if the script code is not valid
      * @stable ICU 2.4
      */
     public static final String getName(int scriptCode){
@@ -1182,10 +1185,13 @@ public final class UScript {
     }
 
     /**
-     * Gets a script name associated with the given script code.
-     * Returns  "Mlym" given MALAYAM
+     * Returns the 4-letter ISO 15924 script code,
+     * which is the same as the short Unicode script name if Unicode has names for the script.
+     * Returns "Mlym" given MALAYALAM.
+     *
      * @param scriptCode int script code
-     * @return script abbreviated name as a string  as given in TR#24
+     * @return short script name (4-letter code)
+     * @throws IllegalArgumentException if the script code is not valid
      * @stable ICU 2.4
      */
     public static final String getShortName(int scriptCode){