- * Choose the best mode by examining the content.
- *
- * Note that this function does not return MODE_KANJI, as we cannot distinguish Shift_JIS from
- * other encodings such as ISO-8859-1, from data bytes alone. For example "\xE0\xE0" can be
- * interpreted as one character in Shift_JIS, but also two characters in ISO-8859-1.
+ * Choose the best mode by examining the content. Note that 'encoding' is used as a hint;
+ * if it is Shift_JIS then we assume the input is Kanji and return {@link Mode#KANJI}.