diff --git a/hadoop-common-project/hadoop-auth/pom.xml b/hadoop-common-project/hadoop-auth/pom.xml
index 752682ca7c6..9819b3fe084 100644
--- a/hadoop-common-project/hadoop-auth/pom.xml
+++ b/hadoop-common-project/hadoop-auth/pom.xml
@@ -110,6 +110,7 @@
Also includes utilities for efficiently reading and writing UTF-8.
*
+ * Note that this decodes UTF-8 but actually encodes CESU-8, a variant of
+ * UTF-8: see http://en.wikipedia.org/wiki/CESU-8
+ *
* @deprecated replaced by Text
*/
@Deprecated
@@ -151,6 +156,21 @@ public class UTF8 implements WritableComparableo
is a UTF8 with the same contents. */
@Override
@@ -209,6 +229,19 @@ public class UTF8 implements WritableComparable