Changeset 11383

Timestamp:

23 Feb 2014, 13:45:34 (11 years ago)

Author:

uli

Message:

More about virtualenvs.

File:

• main/waeup.aaua/trunk/INSTALL.txt (modified) (3 diffs)

main/waeup.aaua/trunk/INSTALL.txt

@@ -104 +104 @@
 ==================
 
-This step is only necessary (and recommended) if you installed
-`virtualenv` before.
-
-As a normal user you now can create a sandbox for your upcoming work
-by::
-
-  $ virtualenv --no-site-packages mysandbox
-
-where ``mysandbox`` is a directory in the filesystem where your
-sandbox will be created. `virtualenv` will also create this directory
-for you.
+After installing `virtualenv`_ you can install local sandboxes like
+this::
+
+  $ virtualenv --no-site-packages py27
+
+where ``py27`` is a directory in the filesystem where your sandbox
+will be created. `virtualenv` will also create this directory for
+you. It is recommended to use a sandbox name that is short and at the
+same time reflects the Python version used (here: Python 2.7).
 
 By passing the ``no-site-packages`` switch we tell `virtualenv` to
 provide us a clean environment without any extra-packages installed
-systemwide.
+systemwide. More recent versions of `virtualenv`_ have this option set
+by default.
+
+Another often used option of `virtualenv`_ is ``-p``. With ``-p`` you
+can tell `virtualenv`_ which Python executable to use as base for the
+new sandbox.
 
 You now can activate the sandbox by doing::
 
-  $ source mysandbox/bin/activate
+  $ source py27/bin/activate
+  (py27)$
 
 You will notice that the input prompt changes.
@@ -128 +132 @@
 To deactivate the sandbox at any time, enter::
 
-  (sandbox27)$ deactivate
+  (py27)$ deactivate
 
 and the prompt will be the same as before the activation.
@@ -142 +146 @@
 sources of Kofa from the subversion server::
 
-  (sandbox27)$ cd mysandbox/
-  (sandbox27)$ svn co https://svn.waeup.org/repos/main/waeup.kofa/trunk kofa-trunk
+  (py27)$ cd mysandbox/
+  (py27)$ svn co https://svn.waeup.org/repos/main/waeup.kofa/trunk kofa-trunk
 
 where ``kofa-trunk`` is only a name we've chosen here to make clear