ICU-7118 Javadoc changes only

X-SVN-Rev: 36360

diff --git a/icu4j/main/classes/collate/src/com/ibm/icu/text/CollationKey.java b/icu4j/main/classes/collate/src/com/ibm/icu/text/CollationKey.java
index af98ad942dd84072f8eac38e6ff86be9a38f0b1d..906afe2f507d370e136074620d5b526d9a4f9dae 100644 (file)
--- a/icu4j/main/classes/collate/src/com/ibm/icu/text/CollationKey.java
+++ b/icu4j/main/classes/collate/src/com/ibm/icu/text/CollationKey.java
@@ -24,7 +24,10 @@ import com.ibm.icu.impl.coll.Collation;
  * <code>CollationKey.compareTo(CollationKey)</code> and the method
  * <code>Collator.compare(String, String)</code> compare two strings
  * and returns their relative order.  The performance characterictics
- * of these two approaches can differ.</p>
+ * of these two approaches can differ.
+ * Note that collation keys are often less efficient than simply doing comparison. 
+ * For more details, see the ICU User Guide.
+ * </p>
  *
  * <p>During the construction of a <code>CollationKey</code>, the
  * entire source string is examined and processed into a series of

diff --git a/icu4j/main/classes/collate/src/com/ibm/icu/text/Collator.java b/icu4j/main/classes/collate/src/com/ibm/icu/text/Collator.java
index d1650939ea7c958f29a75641139f5bf1c0013236..32dde8616bf82b4c4a705f65dd1d4ca7c25f4d07 100644 (file)
--- a/icu4j/main/classes/collate/src/com/ibm/icu/text/Collator.java
+++ b/icu4j/main/classes/collate/src/com/ibm/icu/text/Collator.java
@@ -1246,6 +1246,8 @@ public abstract class Collator implements Comparator<Object>, Freezable<Collator
      * Transforms the String into a CollationKey suitable for efficient
      * repeated comparison.  The resulting key depends on the collator's
      * rules, strength and decomposition mode.
+     * </p></p>Note that collation keys are often less efficient than simply doing comparison. 
+     * For more details, see the ICU User Guide.
      * </p>
      * <p>See the CollationKey class documentation for more information.</p>
      * @param source the string to be transformed into a CollationKey.
@@ -1264,6 +1266,8 @@ public abstract class Collator implements Comparator<Object>, Freezable<Collator
      * the rules of this Collator and stores the result into the user provided argument
      * key.  If key has a internal byte array of length that's too small for the result,
      * the internal byte array will be grown to the exact required size.
+     * </p>Note that collation keys are often less efficient than simply doing comparison. 
+     * For more details, see the ICU User Guide.
      * @param source the text String to be transformed into a RawCollationKey
      * @return If key is null, a new instance of RawCollationKey will be
      *         created and returned, otherwise the user provided key will be