aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorfeeptr@codeberg.org <feeptr>2021-09-27 19:39:39 +0000
committerfeeptr@codeberg.org <feeptr>2021-12-02 23:44:08 +0000
commitfade19b51209fa130bc6f9513307c9614721a0fb (patch)
treea961757328daef10bc7a318d14f087d1cb9c1069
parentconfig, input: allow configuring select-override modifiers (diff)
doc: document select-override-mods
-rw-r--r--doc/foot.ini.5.scd17
-rw-r--r--foot.ini1
2 files changed, 15 insertions, 3 deletions
diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd
index 1b6c4d8c..f84cc9f6 100644
--- a/doc/foot.ini.5.scd
+++ b/doc/foot.ini.5.scd
@@ -470,6 +470,16 @@ applications can change these at runtime.
Default: _yes_.
+*selection-override-modifiers*
+ Modifiers. The set of modifiers which, when held, will override
+ attempts by programs running in the terminal to capture mouse
+ input.
+
+ Any modifiers in this set cannot be used for mouse bindings
+ themselves.
+
+ Default: Shift
+
# SECTION: colors
@@ -865,9 +875,10 @@ of the modifiers *must* be valid XKB key names, and the button name
*must* be a valid libinput name. You can find the button names using
*libinput debug-events*.
-Note that *Shift* cannot be used as a modifier in mouse bindings since
-it is used to enable selection when the client application is grabbing
-the mouse.
+Note that the modifiers set in *mouse.selection-override-modifiers*
+(by default, *Shift*) cannot be used as modifiers in mouse bindings
+since they are used to enable selection when the client application is
+grabbing the mouse.
The trailing *COUNT* is optional and specifies the click count
required to trigger the binding. The default if *COUNT* is omitted is
diff --git a/foot.ini b/foot.ini
index 09049b68..d756a7e4 100644
--- a/foot.ini
+++ b/foot.ini
@@ -63,6 +63,7 @@
[mouse]
# hide-when-typing=no
# alternate-scroll-mode=yes
+# selection-override-modifiers=Shift
[colors]
# alpha=1.0