aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorfeeptr@codeberg.org <feeptr>2021-12-04 16:22:33 +0000
committerfeeptr@codeberg.org <feeptr>2021-12-04 16:22:33 +0000
commita6c543a32c51226282e90f47ae9ac13f37430009 (patch)
tree288191e95a9ad9374924676bac44969cd104318b /doc
parentconfig: improve error reporting when selection-override-modifiers conflict with mouse bindings (diff)
improve documentation for [mouse-bindings].selection-override-modifiers
Diffstat (limited to 'doc')
-rw-r--r--doc/foot.ini.5.scd21
1 files changed, 13 insertions, 8 deletions
diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd
index 5f55dc45..e1922634 100644
--- a/doc/foot.ini.5.scd
+++ b/doc/foot.ini.5.scd
@@ -865,13 +865,6 @@ 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*.
-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
_1_.
@@ -882,7 +875,19 @@ say you want to bind *BTN\_MIDDLE* to *fullscreen*. Since
need to unmap the default binding. This can be done by setting
_action=none_; e.g. *primary-paste=none*.
-All actions listed under *key-bindings* can be used here as well.
+*selection-override-modifiers*
+ The modifiers set in this set (which may be set to any combination
+ of modifiers, e.g. _mod1+mod2+mod3_, as well as _none_) are used
+ to enable selecting text with the mouse irrespective of whether a
+ client application currently has the mouse grabbed.
+ These modifiers cannot be used as modifiers in mouse bindings.
+ Because the order of bindings is significant, it is best to set
+ this prior to any other mouse bindings that might use modifiers in
+ the default set.
+ Default: _Shift_
+
+The actions to which mouse combos can be bound are listed below. All
+actions listed under *key-bindings* can be used here as well.
*select-begin*
Begin an interactive selection. The selection is finalized, and