Unnamed repository; edit this file 'description' to name the repository.
Diffstat (limited to 'book/src/remapping.md')
| -rw-r--r-- | book/src/remapping.md | 18 |
1 files changed, 16 insertions, 2 deletions
diff --git a/book/src/remapping.md b/book/src/remapping.md index 41e20f84..e3baee13 100644 --- a/book/src/remapping.md +++ b/book/src/remapping.md @@ -72,8 +72,22 @@ t = ":run-shell-command cargo test" ## Special keys and modifiers -Ctrl, Shift and Alt modifiers are encoded respectively with the prefixes -`C-`, `S-` and `A-`. Special keys are encoded as follows: +Ctrl, Shift and Alt modifiers are encoded respectively with the prefixes `C-`, `S-` and `A-`. + +The [Super key](https://en.wikipedia.org/wiki/Super_key_(keyboard_button)) - the Windows/Linux +key or the Command key on Mac keyboards - is also supported when using a terminal emulator that +supports the [enhanced keyboard protocol](https://github.com/helix-editor/helix/wiki/Terminal-Support#enhanced-keyboard-protocol). +The super key is encoded with prefixes `Meta-`, `Cmd-` or `Win-`. These are all synonyms for the +super modifier - binding a key with a `Win-` modifier will mean it can be used with the +Windows/Linux key or the Command key. + +```toml +[keys.normal] +C-s = ":write" # Ctrl and 's' to write +Cmd-s = ":write" # Cmd or Win or Meta and 's' to write +``` + +Special keys are encoded as follows: | Key name | Representation | | --- | --- | |