From 46fd479568f98ad94e3e1b0d1935040706d7558c Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sun, 8 Aug 2021 11:00:41 -0400 Subject: Tweak the docs Make the docs for pango_layout_move_cursor_visually a bit more clear. --- pango/pango-layout.c | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/pango/pango-layout.c b/pango/pango-layout.c index 6194862f..ae0bc330 100644 --- a/pango/pango-layout.c +++ b/pango/pango-layout.c @@ -1928,7 +1928,7 @@ pango_layout_line_get_cursors (PangoLayoutLine *line, * @strong: whether the moving cursor is the strong cursor or the * weak cursor. The strong cursor is the cursor corresponding * to text insertion in the base direction for the layout. - * @old_index: the byte index of the grapheme for the old index + * @old_index: the byte index of the current cursor position * @old_trailing: if 0, the cursor was at the leading edge of the * grapheme indicated by @old_index, if > 0, the cursor * was at the trailing edge. @@ -1945,13 +1945,12 @@ pango_layout_line_get_cursors (PangoLayoutLine *line, * end of the preceding line. @new_index is always on the line where * the cursor should be displayed. * - * Computes a new cursor position from an old position and a count of - * positions to move visually. + * Computes a new cursor position from an old position and a direction. * - * If @direction is positive, then the new strong cursor position will be - * one position to the right of the old cursor position. If @direction is - * negative, then the new strong cursor position will be one position to - * the left of the old cursor position. + * If @direction is positive, then the new position will cause the strong + * or weak cursor to be displayed one position to right of where it was + * with the old cursor position. If @direction is negative, it will be + * moved to the left. * * In the presence of bidirectional text, the correspondence between * logical and visual order will depend on the direction of the current -- cgit v1.2.1