From 0c196888fb5993bd2da53f3850d212ad30566ec6 Mon Sep 17 00:00:00 2001 From: Kovid Goyal Date: Fri, 18 Jun 2021 17:56:21 +0530 Subject: [PATCH] Clarify meaning of grabbed/ungrabbed a bit more --- kitty/options/definition.py | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/kitty/options/definition.py b/kitty/options/definition.py index c0bcf6c90..22fc422aa 100644 --- a/kitty/options/definition.py +++ b/kitty/options/definition.py @@ -480,10 +480,11 @@ ``event-type`` is one ``press``, ``release``, ``doublepress``, ``triplepress``, ``click`` and ``doubleclick``. ``modes`` indicates whether the action is -performed when the mouse is grabbed by the terminal application or not. It can -have one or more or the values, ``grabbed,ungrabbed``. Note that the click -and double click events have a delay of :opt:`click_interval` to disambiguate -from double and triple presses. +performed when the mouse is grabbed by the program running in the terminal, or +not. It can have one or more or the values, ``grabbed,ungrabbed``. ``grabbed`` +refers to when the program running in the terminal has requested mouse events. +Note that the click and double click events have a delay of +:opt:`click_interval` to disambiguate from double and triple presses. You can run kitty with the :option:`kitty --debug-input` command line option to see mouse events. See the builtin actions below to get a sense of what is possible.