Minor tweak of the LOK_CALLBACK_TEXT_SELECTION_START / _END docu.

Change-Id: I39a6a20818c4ed92d37b7b5b0a91517ee370adcb

1 files changed, 12 insertions, 10 deletions

diff --git a/include/LibreOfficeKit/LibreOfficeKitEnums.h b/include/LibreOfficeKit/LibreOfficeKitEnums.h
index 671166e079ed..e8d2b59dec45 100644
--- a/include/LibreOfficeKit/LibreOfficeKitEnums.h
+++ b/include/LibreOfficeKit/LibreOfficeKitEnums.h
@@ -63,21 +63,23 @@ typedef enum
      */
     LOK_CALLBACK_TEXT_SELECTION,
     /**
-     * The size and/or the position of the cursor rectangle at the text
-     * selection start changed.
+     * The position and size of the cursor rectangle at the text
+     * selection start. It is used to draw the selection handles.
      *
-     * If this callback is emitted, it's always followed by a
-     * LOK_CALLBACK_TEXT_SELECTION one. Rectangle format is the same as
-     * LOK_CALLBACK_INVALIDATE_TILES.
+     * This callback must be called prior to LOK_CALLBACK_TEXT_SELECTION every
+     * time the selection is updated.
+     *
+     * Rectangle format is the same as LOK_CALLBACK_INVALIDATE_TILES.
      */
     LOK_CALLBACK_TEXT_SELECTION_START,
     /**
-     * The size and/or the position of the cursor rectangle at the text
-     * selection end changed.
+     * The position and size of the cursor rectangle at the text
+     * selection end. It is used to draw the selection handles.
      *
-     * If this callback is emitted, it's always followed by a
-     * LOK_CALLBACK_TEXT_SELECTION one. Rectangle format is the same as
-     * LOK_CALLBACK_INVALIDATE_TILES.
+     * This callback must be called prior to LOK_CALLBACK_TEXT_SELECTION every
+     * time the selection is updated.
+     *
+     * Rectangle format is the same as LOK_CALLBACK_INVALIDATE_TILES.
      */
     LOK_CALLBACK_TEXT_SELECTION_END,
     /**