WebKit merge 41447:41498 [third_party/WebKit]

third_party/WebKit/WebCore/platform/text/TextBreakIterator.h

Index: third_party/WebKit/WebCore/platform/text/TextBreakIterator.h
===================================================================
--- third_party/WebKit/WebCore/platform/text/TextBreakIterator.h	(revision 11154)
+++ third_party/WebKit/WebCore/platform/text/TextBreakIterator.h	(working copy)
@@ -29,7 +29,19 @@
     class TextBreakIterator;
 
     // Note: The returned iterator is good only until you get another iterator.
+
+    // Iterates over "extended grapheme clusters", as defined in UAX #29.
+    // Note that platform implementations may be less sophisticated - e.g. ICU prior to
+    // version 4.0 only supports "legacy grapheme clusters".
+    // Use this for general text processing, e.g. string truncation.
     TextBreakIterator* characterBreakIterator(const UChar*, int length);
+
+    // This is similar to character break iterator in most cases, but is subject to
+    // platform UI conventions. One notable example where this can be different
+    // from character break iterator is Thai prepend characters, see bug 24342.
+    // Use this for insertion point and selection manipulations.
+    TextBreakIterator* cursorMovementIterator(const UChar*, int length);
+
     TextBreakIterator* wordBreakIterator(const UChar*, int length);
     TextBreakIterator* lineBreakIterator(const UChar*, int length);
     TextBreakIterator* sentenceBreakIterator(const UChar*, int length);