From 7e620fed63950b0ff55bae5f1c3de7801308f96e Mon Sep 17 00:00:00 2001
From: Noah Gorny <noah@gittabags.com>
Date: Wed, 14 Apr 2021 16:55:23 +0300
Subject: [PATCH] docs: Add a section about bash-it restart

---
 docs/commands/reload.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/commands/reload.rst b/docs/commands/reload.rst
index 722182d1..03a7064c 100644
--- a/docs/commands/reload.rst
+++ b/docs/commands/reload.rst
@@ -8,3 +8,16 @@ your Bash profile when you make changes.
 
 Additionally, if you export ``BASH_IT_AUTOMATIC_RELOAD_AFTER_CONFIG_CHANGE`` as a non-null value,
 Bash-it will automatically reload itself after activating or deactivating plugins, aliases, or completions.
+
+.. warning::
+  When changing theme, do not use ``bash-it reload``. Instead, use :ref:`restart`.
+
+.. _restart:
+
+Bash-it restart
+^^^^^^^^^^^^^^^
+
+Similar to :ref:`reload`, ``bash-it restart`` can be used to restart your shell.
+Instead of reloading your Bash profile, this command re-runs Bash (using exec).
+
+This is stronger than simple reload, and is similar to the effect of closing and reopening your terminal.