aboutsummaryrefslogtreecommitdiff
path: root/book
diff options
context:
space:
mode:
authorLinden Krouse2024-05-01 20:48:08 +0000
committerJJ2024-05-01 23:06:27 +0000
commit0a08d7eb5e5049dee8804dffcb110d7d27503810 (patch)
tree9d0a565114788738e1bfa125faaa842ce57f4d9d /book
parent3bff36ab90aba7de8bb5bff7dbb8230d81cdf582 (diff)
Add unbind-default-keys config option
ref: https://github.com/helix-editor/helix/issues/2720 ref: https://github.com/helix-editor/helix/pull/2733
Diffstat (limited to 'book')
-rw-r--r--book/src/remapping.md18
1 files changed, 18 insertions, 0 deletions
diff --git a/book/src/remapping.md b/book/src/remapping.md
index d762c6ad..d23950aa 100644
--- a/book/src/remapping.md
+++ b/book/src/remapping.md
@@ -75,5 +75,23 @@ Ctrl, Shift and Alt modifiers are encoded respectively with the prefixes
Keys can be disabled by binding them to the `no_op` command.
+To remove all default bindings, `unbind-default-keys = true` can be added to the top level configuration.
+
+```toml
+unbind-default-keys = true
+
+# Only these normal mode bindings will be used
+[keys.normal]
+n = "normal_mode"
+t = "goto_definition"
+
+# remember to add bindings to return to normal mode
+[keys.select]
+esc = "normal_mode"
+
+[keys.insert]
+esc = "normal_mode"
+```
+
A list of commands is available in the [Keymap](https://docs.helix-editor.com/keymap.html) documentation
and in the source code at [`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 and the `TypableCommandList`.