readme: Document keybinding overrides

This commit is contained in:
Tor Hedin Brønner
2018-08-02 15:10:32 +02:00
parent 02eccb50db
commit b2d1d73eea

View File

@@ -147,7 +147,11 @@ Available application actions can be listed like this:
app.action_group.list_actions();
```
### User-defined keybindings
### Keybindings
Due to limitations in the mutter keybinding API we need to steal some built in Gnome Shell actions by default. Eg. the builtin action `switch-group` with the default <kbd>Super</kbd><kbd>Above_Tab</kbd> keybinding is overriden to cycle through recently used workspaces. If an overriden action have several keybindings they will unfortunately all activate the override, so for instance because <kbd>Alt</kbd><kbd>Above_Tab</kbd> is also bound to `switch-group` it will be overriden by default. If you want to avoid this, eg. you want <kbd>Alt</kbd><kbd>Tab</kbd> and <kbd>Alt</kbd><kbd>Above_Tab</kbd> to use the builtin behavior simply remove the conflicts (ie. <kbd>Super</kbd><kbd>Tab</kbd> and <kbd>Super</kbd><kbd>Above_Tab</kbd> and their <kbd>Shift</kbd> variants) from `/org/gnome/desktop/wm/keybindings/switch-group` (no restarts required).
#### User defined keybindings
`Extension.imports.keybindings.bindkey(keystr, name, handler, options)`