doc: foot.ini: key-bindings: untranslated symbols are tried before translated

This commit is contained in:
Daniel Eklöf 2025-04-18 14:43:36 +02:00
parent 30aafce82d
commit 155c7c96b7
No known key found for this signature in database
GPG key ID: 5BBD4992C116573F

View file

@ -1190,17 +1190,18 @@ different approaches.
As an example, let's say you press ctrl+shift+c (assume plain us ASCII As an example, let's say you press ctrl+shift+c (assume plain us ASCII
layout). XKB will tell foot *Control+C* was pressed. Note the lack of layout). XKB will tell foot *Control+C* was pressed. Note the lack of
the shift modifier, and the upper case 'C'. Internally, this is called the shift modifier, and the upper case 'C'. Internally, this is called
the "translated" form, and is what foot tries to match first. the "translated" form.
If no "translated" key bindings can be found, foot proceeds to The "untranslated" form (*Control+Shift+c*) is derived from the
checking the "untranslated" variant. Using the same example as above, translated form, and is what foot tries to match first.
this will match *Control+Shift+c* (shift modifier present, lower case
'c'). If no "untranslated" key bindings can be found, foot proceeds to
checking the "translated" variant.
This means you can use either form in your foot configuration, and This means you can use either form in your foot configuration, and
that *Control+C* (and similar) has higher priority than that *Control+Shift+c* (and similar) has higher priority than
*Control+Shift+c*. Also note that while foot normally detects when the *Control+C*. Also note that while foot normally detects when the same
same combination is assigned to multiple actions, it will not detect combination is assigned to multiple actions, it will not detect
*Control+C* vs. *Control+Shift+c* collisions. Call it a known bug... *Control+C* vs. *Control+Shift+c* collisions. Call it a known bug...
Finally, foot tries to match the raw key code. Here, the primary Finally, foot tries to match the raw key code. Here, the primary