summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorAndrew Svetlov <andrew.svetlov@gmail.com>2012-10-04 18:48:58 (GMT)
committerAndrew Svetlov <andrew.svetlov@gmail.com>2012-10-04 18:48:58 (GMT)
commit65e9c57369af9acb3909057545168f72b7dd5ba5 (patch)
tree356a4e1d2366a9269c54affeb6e372f575b685d5 /Doc
parent997adb58191b63d9f12626a1e04770f496a0d9f3 (diff)
downloadcpython-65e9c57369af9acb3909057545168f72b7dd5ba5.zip
cpython-65e9c57369af9acb3909057545168f72b7dd5ba5.tar.gz
cpython-65e9c57369af9acb3909057545168f72b7dd5ba5.tar.bz2
Issue #15417: Add support for csh and fish in venv activation scripts.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/using/venv-create.inc29
1 files changed, 15 insertions, 14 deletions
diff --git a/Doc/using/venv-create.inc b/Doc/using/venv-create.inc
index 5fdbc9b..706ac5d 100644
--- a/Doc/using/venv-create.inc
+++ b/Doc/using/venv-create.inc
@@ -56,20 +56,21 @@ virtualenv will be created, according to the given options, at each
provided path.
Once a venv has been created, it can be "activated" using a script in the
-venv's binary directory. The invocation of the script is platform-specific: on
-a Posix platform, you would typically do::
-
- $ source <venv>/bin/activate
-
-whereas on Windows, you might do::
-
- C:\> <venv>/Scripts/activate
-
-if you are using the ``cmd.exe`` shell, or perhaps::
-
- PS C:\> <venv>/Scripts/Activate.ps1
-
-if you use PowerShell.
+venv's binary directory. The invocation of the script is platform-specific:
+
++-------------+-----------------+-----------------------------------------+
+| Platform | Shell | Command to activate virtual environment |
++=============+=================+=========================================+
+| Posix | bash/zsh | $ source <venv>/bin/activate |
++-------------+-----------------+-----------------------------------------+
+| | fish | $ . <venv>/bin/activate.fish |
++-------------+-----------------+-----------------------------------------+
+| | csh/tcsh | $ source <venv>/bin/activate.csh |
++-------------+-----------------+-----------------------------------------+
+| Windows | cmd.exe | C:\> <venv>/Scripts/activate.bat |
++-------------+-----------------+-----------------------------------------+
+| | PowerShell | PS C:\> <venv>/Scripts/Activate.ps1 |
++-------------+-----------------+-----------------------------------------+
You don't specifically *need* to activate an environment; activation just
prepends the venv's binary directory to your path, so that "python" invokes the