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 dc75e556e78d31114d653224e30e21f845c33313..0569f717408a032e107281df04d147a7d1e41313 100644 (file)
--- 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){