summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/config.txt4
-rw-r--r--doc/example/jenkins.txt20
-rw-r--r--doc/install.txt2
3 files changed, 22 insertions, 4 deletions
diff --git a/doc/config.txt b/doc/config.txt
index 229f357..d99e91c 100644
--- a/doc/config.txt
+++ b/doc/config.txt
@@ -105,7 +105,7 @@ Complete list of settings that you can put into ``testenv*`` sections:
**default**::
- python -m pip install {opts} {packages}
+ pip install {opts} {packages}
.. confval:: list_dependencies_command
@@ -117,7 +117,7 @@ Complete list of settings that you can put into ``testenv*`` sections:
**default**::
- python -m pip freeze
+ pip freeze
.. confval:: ignore_errors=True|False(default)
diff --git a/doc/example/jenkins.txt b/doc/example/jenkins.txt
index b93bec4..94cb22d 100644
--- a/doc/example/jenkins.txt
+++ b/doc/example/jenkins.txt
@@ -44,7 +44,7 @@ for example with ``py.test`` it is done like this:
.. note::
This feature is broken currently because "toxbootstrap.py"
- has been removed. Please file an issue if you'd like to
+ has been removed. Please file an issue if you'd like to
see it back.
If you manage many Jenkins slaves and want to use the latest officially
@@ -151,6 +151,24 @@ So if you are using defaults you can re-use and debug exactly the
same ``tox.ini`` file and make use of automatic sharing of
your artifacts between runs or Jenkins jobs.
+
+Avoiding the "path too long" error with long shebang lines
+---------------------------------------------------------------
+
+If you are using Jenkins builds you might run into the issue
+that tox can not call ``pip`` because the so called "shebang"
+line is too long. There is a limit of 127 chars on some systems.
+Probably the best way to fix the problem is to use the
+new ``--workdir`` option which tells tox to use a specific
+directory for its virtualenvironments. Set it to some unique
+enough short path. If somebody is interested to do a PR
+you could add a new option to tox which uses a random
+directory for storing its workdir results and removes
+it after the tox run finishes. This could be used
+from CI environments where you probably anyway want
+to recreate everything on new runs.
+
+
.. include:: ../links.txt
diff --git a/doc/install.txt b/doc/install.txt
index 7e5d547..982cefb 100644
--- a/doc/install.txt
+++ b/doc/install.txt
@@ -4,7 +4,7 @@ tox installation
Install info in a nutshell
----------------------------------
-**Pythons**: CPython 2.6-3.3, Jython-2.5.1, pypy-1.9ff
+**Pythons**: CPython 2.6-3.5, Jython-2.5.1, pypy-1.9ff
**Operating systems**: Linux, Windows, OSX, Unix