From bf5d8d48c22139feb80be16c1b59f91463682ae9 Mon Sep 17 00:00:00 2001
From: CJ van den Berg <cj@vdbonline.com>
Date: Thu, 5 Dec 2024 14:34:12 +0100
Subject: [PATCH] docs: add note about inheriting from other keybinding modes

---
 help.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/help.md b/help.md
index b3200ba..d50a9c6 100644
--- a/help.md
+++ b/help.md
@@ -53,6 +53,22 @@ keybinding file from the configuration `keys` directory to revert the mode
 to it's built-in definition (if there is one). Changes to keybinding files
 will take effect on restart.
 
+Keybinding modes may inherit all non-conflicting keybindings from another mode
+by adding an `inherit` option to the `settings` section of the keybind file
+like this:
+
+```json
+{
+    "settings": {
+        "inherit": "vim",
+    },
+    "normal": {
+    ...
+```
+
+This allows you to make only minor additions/changes to an existing builtin
+mode without copying the whole mode and is easier to keep up-to-date.
+
 ## Flow mode
 
 The default input mode, called just flow, is based on common GUI