summaryrefslogtreecommitdiff
path: root/plugins/virtualenv/README.md
diff options
context:
space:
mode:
authorSagar Patil <sagar010797@gmail.com>2018-10-13 01:24:26 +0530
committerMarc Cornellà <marc.cornella@live.com>2018-10-12 21:54:26 +0200
commit96f4a938383e558e8f800ccc052a80c6f743555d (patch)
treec40186edbfb5fb32b0309644480c97310b1a37af /plugins/virtualenv/README.md
parentb2f51a1a0a6dd2cb2baeb3e1131b5d41ee03a66d (diff)
downloadzsh-96f4a938383e558e8f800ccc052a80c6f743555d.tar.gz
zsh-96f4a938383e558e8f800ccc052a80c6f743555d.tar.bz2
zsh-96f4a938383e558e8f800ccc052a80c6f743555d.zip
virtualenv: add README (#7273)
Diffstat (limited to 'plugins/virtualenv/README.md')
-rw-r--r--plugins/virtualenv/README.md15
1 files changed, 15 insertions, 0 deletions
diff --git a/plugins/virtualenv/README.md b/plugins/virtualenv/README.md
new file mode 100644
index 000000000..e0b8c2c82
--- /dev/null
+++ b/plugins/virtualenv/README.md
@@ -0,0 +1,15 @@
+# virtualenv
+
+The plugin displays information of the created virtual container and allows background theming.
+
+To use it, add `virtualenv` to the plugins array of your zshrc file:
+```
+plugins=(... virtualenv)
+```
+
+The plugin creates a `virtualenv_prompt_info` function that you can use in your theme, which displays
+the basename of the current `$VIRTUAL_ENV`. It uses two variables to control how that is shown:
+
+- `ZSH_THEME_VIRTUALENV_PREFIX`: sets the prefix of the VIRTUAL_ENV. Defaults to `[`.
+
+- `ZSH_THEME_VIRTUALENV_SUFFIX`: sets the suffix of the VIRTUAL_ENV. Defaults to `]`.