mirrors/foot
1
0
Fork 0
mirror of https://codeberg.org/dnkl/foot.git synced 2026-02-05 04:06:08 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

improve documentation for [mouse-bindings].selection-override-modifiers

Browse source
This commit is contained in:
feeptr@codeberg.org 2021-12-04 16:22:33 +00:00
parent a15c6025ec
commit a6c543a32c
1 changed files with 13 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

21
doc/foot.ini.5.scd
View file

@ -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