From a70fa7fd8a74936b704b5b26086bf6c695d34bb9 2021-04-14 23:39:40
From: Matthias Bussonnier <bussonniermatthias@gmail.com>
Date: 2021-04-14 23:39:40
Subject: [PATCH] Merge pull request #12894 from Carreau/suggest-xonsh

Inform user they shoudl use Xonsh instead of system shell
---

diff --git a/docs/source/interactive/shell.rst b/docs/source/interactive/shell.rst
index 3c72702..0ea125c 100644
--- a/docs/source/interactive/shell.rst
+++ b/docs/source/interactive/shell.rst
@@ -1,5 +1,11 @@
 .. _ipython_as_shell:
 
+.. note::
+
+   This page has been kept for historical reason. You most likely want to use
+   `Xonsh <https://xon.sh/>`__ instead of this.
+
+
 =========================
 IPython as a system shell
 =========================
@@ -44,6 +50,10 @@ so you should be able to type any normal system command and have it executed.
 See ``%alias?``  and ``%unalias?`` for details on the alias facilities. See also
 ``%rehashx?`` for details on the mechanism used to load $PATH.
 
+.. warning::
+
+   See info at the top of the page. You most likely want to use
+   `Xonsh <https://xon.sh/>`__ instead of this.
 
 Directory management
 ====================
@@ -196,3 +206,9 @@ provide a convenient ways to use contained text in different formats:
 * ``.s`` returns string with lines separated by single space (for
   convenient passing to system commands)
 * ``.p`` returns list of "path" objects from detected file names
+
+.. error::
+
+   You went too far scroll back up. You most likely want to use
+   `Xonsh <https://xon.sh/>`__ instead of this.
+