aboutsummaryrefslogtreecommitdiff
path: root/doc
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 /doc
parentconfig, input: allow configuring select-override modifiers (diff)
doc: document select-override-mods
Diffstat (limited to 'doc')
-rw-r--r--doc/foot.ini.5.scd17
1 files changed, 14 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