summaryrefslogtreecommitdiff
path: root/doc/subprocess.rst
diff options
context:
space:
mode:
authorNed Batchelder <ned@nedbatchelder.com>2019-12-11 05:01:37 -0500
committerNed Batchelder <ned@nedbatchelder.com>2019-12-11 05:01:37 -0500
commit5379317ad73694099b7876797695bc76bd9cdce5 (patch)
tree5e2e7732fff98cc87244e2d5a9df0b91c681e760 /doc/subprocess.rst
parenteebc1e9c93f97d03c481336607668e93b926c181 (diff)
downloadpython-coveragepy-git-5379317ad73694099b7876797695bc76bd9cdce5.tar.gz
Clarify the connection between subprocesses and --concurrency
Diffstat (limited to 'doc/subprocess.rst')
-rw-r--r--doc/subprocess.rst6
1 files changed, 6 insertions, 0 deletions
diff --git a/doc/subprocess.rst b/doc/subprocess.rst
index 516e2030..c09d45f1 100644
--- a/doc/subprocess.rst
+++ b/doc/subprocess.rst
@@ -22,6 +22,12 @@ the name of the :ref:`configuration file <config>` to use.
The subprocess only sees options in the configuration file. Options set on
the command line will not be used in the subprocesses.
+.. note::
+ If you have subprocesses because you are using :mod:`multiprocessing
+ <python:multiprocessing>`, the ``--concurrency=multiprocessing``
+ command-line option should take care of everything for you. See
+ :ref:`cmd_run` for details.
+
When using this technique, be sure to set the parallel option to true so that
multiple coverage.py runs will each write their data to a distinct file.