From 8a9234ba4f4066f461f0b098136c25989da14368 Mon Sep 17 00:00:00 2001
From: Kovid Goyal <kovid@kovidgoyal.net>
Date: Thu, 15 Jul 2021 10:28:02 +0530
Subject: [PATCH] Move shell integration docs into own file

---
 docs/overview.rst          | 15 +++++++++++++++
 docs/shell-integration.rst |  4 ++++
 2 files changed, 19 insertions(+)
 create mode 100644 docs/shell-integration.rst

diff --git a/docs/overview.rst b/docs/overview.rst
index bb4f2b9dc..529a59331 100644
--- a/docs/overview.rst
+++ b/docs/overview.rst
@@ -252,6 +252,21 @@ If you wish to store very large amounts of scrollback to view using the piping o
 :sc:`show_scrollback` features, you can use the :opt:`scrollback_pager_history_size`
 option.
 
+
+Shell integration
+---------------------------------
+
+kitty has the ability to integrate closely within common shells, such as `zsh
+<https://www.zsh.org/>`_ and `bash <https://www.gnu.org/software/bash/>`_ to enable
+features such as jumping to previous prompts in the scrollback, viewing the
+output of the last command in less, using the mouse to move the cursor
+while editing prompts, etc. See :doc:`shell-integration` for details.
+
+.. toctree::
+   :hidden:
+
+   shell-integration
+
 .. _cpbuf:
 
 Multiple copy/paste buffers
diff --git a/docs/shell-integration.rst b/docs/shell-integration.rst
new file mode 100644
index 000000000..bebb0e100
--- /dev/null
+++ b/docs/shell-integration.rst
@@ -0,0 +1,4 @@
+.. _shell_integration:
+
+Shell integration
+======================