aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorfeeptr@codeberg.org <feeptr>2021-11-29 22:06:35 +0000
committerfeeptr@codeberg.org <feeptr>2021-12-02 23:47:41 +0000
commitb52cd67467cb5e5f334f00680b42f8e071be1e79 (patch)
treefc59069b129ca40a83b51f5d6671b7c9de5ea51c /doc
parentconfig: parse 'none' as empty modifiers value (diff)
config, doc, changelog: move selection-override-modifiers to [mouse-bindings] and validate other case
specifically, check for conflicts both when mouse bindings are set and when the selection-override-modifiers setting itself is set
Diffstat (limited to 'doc')
-rw-r--r--doc/foot.ini.5.scd20
1 files changed, 6 insertions, 14 deletions
diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd
index f84cc9f6..5f55dc45 100644
--- a/doc/foot.ini.5.scd
+++ b/doc/foot.ini.5.scd
@@ -470,16 +470,6 @@ 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
@@ -875,10 +865,12 @@ 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 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 modifiers set in *[mouse-bindings].selection-override-modifiers*
+(by default, *Shift*) cannot be used as modifiers in mouse bindings,
+and are instead used to enable selecting text with the mouse
+irrespective of whether a client application currently has the mouse
+grabbed. Because the order of bindings is significant, it's best to
+set this prior to any other mouse bindings that might use *Shift*.
The trailing *COUNT* is optional and specifies the click count
required to trigger the binding. The default if *COUNT* is omitted is