From b96cdc6199b090e47f57933576cc89e18b0a6656 Mon Sep 17 00:00:00 2001
From: Mark Davis <mark@macchiato.com>
Date: Fri, 5 Sep 2014 14:41:18 +0000
Subject: [PATCH] ICU-7118 Javadoc changes only

X-SVN-Rev: 36360
---
 .../classes/collate/src/com/ibm/icu/text/CollationKey.java   | 5 ++++-
 .../main/classes/collate/src/com/ibm/icu/text/Collator.java  | 4 ++++
 2 files changed, 8 insertions(+), 1 deletion(-)

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 af98ad942dd..906afe2f507 100644
--- 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 d1650939ea7..32dde8616bf 100644
--- 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
-- 
2.40.0