diff options
| -rw-r--r-- | wiki/Configuration:-Key-Bindings.md | 9 |
1 files changed, 9 insertions, 0 deletions
diff --git a/wiki/Configuration:-Key-Bindings.md b/wiki/Configuration:-Key-Bindings.md index 5634bb5e..07c96d60 100644 --- a/wiki/Configuration:-Key-Bindings.md +++ b/wiki/Configuration:-Key-Bindings.md @@ -52,6 +52,15 @@ For this reason, most of the default keys use the `Mod` modifier. > > Here, look at `sym: Left` and `sym: Right`: these are the key names. > I was pressing the left and the right arrow in this example. +> +> Keep in mind that binding shifted keys requires spelling out Shift and the unshifted version of the key, according to your XKB layout. +> For example, on the US QWERTY layout, <kbd><</kbd> is on <kbd>Shift</kbd> + <kbd>,</kbd>, so to bind it, you spell out something like `Mod+Shift+Comma`. +> +> As another example, if you've configured the French [BÉPO](https://en.wikipedia.org/wiki/B%C3%89PO) XKB layout, your <kbd><</kbd> is on <kbd>AltGr</kbd> + <kbd>«</kbd>. +> <kbd>AltGr</kbd> is `ISO_Level3_Shift`, or equivalently `Mod5`, so to bind it, you spell out something like `Mod+Mod5+guillemotleft`. +> +> When resolving latin keys, niri will search for the *first* configured XKB layout that has the latin key. +> So for example with US QWERTY and RU layouts configured, US QWERTY will be used for latin binds. <sup>Since: 0.1.8</sup> Binds will repeat by default (i.e. holding down a bind will make it trigger repeatedly). You can disable that for specific binds with `repeat=false`: |