From 4b19eac5c8e45a684a71d6790545af41de8a927c Mon Sep 17 00:00:00 2001
From: Thorsten Ball <mrnugget@gmail.com>
Date: Thu, 20 Jun 2024 11:03:18 +0200
Subject: [PATCH] docs: Explain how to forward keys to the terminal (#13298)

Follow-up to https://github.com/zed-industries/zed/pull/13263

Release Notes:

- N/A
---
 docs/src/key-bindings.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/docs/src/key-bindings.md b/docs/src/key-bindings.md
index 09f41d68ca..14124c69a6 100644
--- a/docs/src/key-bindings.md
+++ b/docs/src/key-bindings.md
@@ -102,6 +102,21 @@ There are some limitations to this, notably:
 
 The argument to `SendKeystrokes` is a space-separated list of keystrokes (using the same syntax as above). Due to the way that keystrokes are parsed, any segment that is not recognized as a keypress will be sent verbatim to the currently focused input field.
 
+### Forward keys to terminal
+
+If you're on Linux or Windows, you might find yourself wanting to forward key combinations to the built-in terminal instead of them being handled by Zed.
+
+For example, `ctrl-n` creates a new tab in Zed on Linux. If you want to send `ctrl-n` to the built-in terminal when it's focused, add the following to your keymap:
+
+```json
+{
+  "context": "Terminal",
+  "bindings": {
+    "ctrl-n": ["terminal::SendKeystroke", "ctrl-n"]
+  }
+}
+```
+
 ### All key bindings
 
 #### Global