Add faq entry about re-use of environments

tox-dev · Dec 29, 2022 · a0a816d · a0a816d
1 parent e0aed50
commit a0a816d
Show file tree

Hide file tree

Showing 2 changed files with 18 additions and 0 deletions.
diff --git a/docs/changelog/2788.doc.rst b/docs/changelog/2788.doc.rst
@@ -0,0 +1 @@
+Add faq entry about re-use of environments - by :user:`jugmac00`.
diff --git a/docs/faq.rst b/docs/faq.rst
@@ -121,6 +121,23 @@ tox 4 -- output changes
 - We now use colors for reporting, to help make the output easier to read for humans. This can be disabled via the
   ``TERM=dumb`` or ``NO_COLOR=1`` environment variables, or the ``--colored no`` CLI argument.
 
+tox 4 -- re-use of environments
++++++++++++++++++++++++++++++++
+
+- It is no longer possible to re-use environments. While this might have been possible with tox version 3, this
+  behavior was never supported, and possibly caused wrong results as illustrated in the following example.
+
+.. code-block:: ini
+
+    [testenv]
+    envdir = .tox/venv
+
+    [testenv:a]
+    deps = pytest>7
+
+    [testenv:b]
+    deps = pytest<7
+
 New features in tox 4
 ---------------------
 Here is a non-exhaustive list of these.