Unnamed repository; edit this file 'description' to name the repository.
Diffstat (limited to 'book/src/remapping.md')
| -rw-r--r-- | book/src/remapping.md | 72 |
1 files changed, 23 insertions, 49 deletions
diff --git a/book/src/remapping.md b/book/src/remapping.md index 9a9a611a..41e20f84 100644 --- a/book/src/remapping.md +++ b/book/src/remapping.md @@ -12,7 +12,7 @@ There are three kinds of commands that can be used in keymaps: in [`helix-term/src/commands.rs`](https://github.com/helix-editor/helix/blob/master/helix-term/src/commands.rs) at the invocation of `static_commands!` macro. * Typable commands: commands that can be executed from command mode (`:`), for - example `:write!`. See the [Commands](./commands.md) documentation for a + example `:write!`. See the [Commands](./commands.html) documentation for a list of available typeable commands or the `TypableCommandList` declaration in the source code at [`helix-term/src/commands/typed.rs`](https://github.com/helix-editor/helix/blob/master/helix-term/src/commands/typed.rs). * Macros: sequences of keys that are executed in order. These keybindings @@ -72,53 +72,27 @@ 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-`. - -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 | -| --- | --- | -| Backspace | `"backspace"` | -| Space | `"space"` | -| Return/Enter | `"ret"` | -| Left | `"left"` | -| Right | `"right"` | -| Up | `"up"` | -| Down | `"down"` | -| Home | `"home"` | -| End | `"end"` | -| Page Up | `"pageup"` | -| Page Down | `"pagedown"` | -| Tab | `"tab"` | -| Delete | `"del"` | -| Insert | `"ins"` | -| Null | `"null"` | -| Escape | `"esc"` | -| Less Than (<) | `"lt"` | -| Greater Than (>) | `"gt"` | +Ctrl, Shift and Alt modifiers are encoded respectively with the prefixes +`C-`, `S-` and `A-`. Special keys are encoded as follows: + +| Key name | Representation | +| --- | --- | +| Backspace | `"backspace"` | +| Space | `"space"` | +| Return/Enter | `"ret"` | +| \- | `"minus"` | +| Left | `"left"` | +| Right | `"right"` | +| Up | `"up"` | +| Down | `"down"` | +| Home | `"home"` | +| End | `"end"` | +| Page Up | `"pageup"` | +| Page Down | `"pagedown"` | +| Tab | `"tab"` | +| Delete | `"del"` | +| Insert | `"ins"` | +| Null | `"null"` | +| Escape | `"esc"` | Keys can be disabled by binding them to the `no_op` command. - -All other keys such as `?`, `!`, `-` etc. can be used literally: - -```toml -[keys.normal] -"?" = ":write" -"!" = ":write" -"-" = ":write" -``` - -Note: `-` can't be used when combined with a modifier, for example `Alt` + `-` should be written as `A-minus`. `A--` is not accepted. |