text: introduce functions to iterate over graphemes

They currently consider any character for which wcwidth(3)
return 0 as a combining character.

1 files changed, 4 insertions, 4 deletions

diff --git a/text-motions.h b/text-motions.h
index d65bdf2..57aa09e 100644
--- a/text-motions.h
+++ b/text-motions.h
@@ -12,7 +12,7 @@
 size_t text_begin(Text*, size_t pos);
 size_t text_end(Text*, size_t pos);
 
-/* move to start of next / previous UTF-8 character */
+/* char refers to a grapheme (might skip over multiple Unicode codepoints) */
 size_t text_char_next(Text*, size_t pos);
 size_t text_char_prev(Text*, size_t pos);
 
@@ -39,11 +39,11 @@ size_t text_line_lastchar(Text*, size_t pos);
 size_t text_line_end(Text*, size_t pos);
 size_t text_line_next(Text*, size_t pos);
 size_t text_line_offset(Text*, size_t pos, size_t off);
-/* get character count of the line upto `pos' */
+/* get grapheme count of the line upto `pos' */
 int text_line_char_get(Text*, size_t pos);
-/* get position of the `count' character in the line containing `pos' */
+/* get position of the `count' grapheme in the line containing `pos' */
 size_t text_line_char_set(Text*, size_t pos, int count);
-/* move to the next/previous character on the same line */
+/* move to the next/previous grapheme on the same line */
 size_t text_line_char_next(Text*, size_t pos);
 size_t text_line_char_prev(Text*, size_t pos);
 /* move to the next/previous empty line */