summaryrefslogtreecommitdiff
path: root/doc/subprocess.rst
diff options
context:
space:
mode:
authorNed Batchelder <ned@nedbatchelder.com>2010-10-25 17:28:33 -0400
committerNed Batchelder <ned@nedbatchelder.com>2010-10-25 17:28:33 -0400
commita1bcb2f1b57efedb78d1f8861202dcceba99c884 (patch)
tree6a3bc709a9d01c9195b0a6bd5bda29415420d454 /doc/subprocess.rst
parent8ed0b777d297f7266642e514bea26709c6f0ad03 (diff)
downloadpython-coveragepy-git-a1bcb2f1b57efedb78d1f8861202dcceba99c884.tar.gz
Clarify some docs.
Diffstat (limited to 'doc/subprocess.rst')
-rw-r--r--doc/subprocess.rst8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/subprocess.rst b/doc/subprocess.rst
index 383c797f..bcf50445 100644
--- a/doc/subprocess.rst
+++ b/doc/subprocess.rst
@@ -26,6 +26,14 @@ multiple coverage.py runs will each write their data to a distinct file.
Configuring Python for subprocess coverage
------------------------------------------
+To measure coverage in subprocesses, you have to do two things: set a value for
+the ``COVERAGE_PROCESS_START`` environment variable, and then invoke
+:func:`coverage.process_startup`.
+
+How you set ``COVERAGE_PROCESS_START`` depends on the details of how you create
+subprocesses. As long as the environment variable is visible in your subprocess,
+it will work.
+
You can configure your Python installation to invoke the ``process_startup``
function in two ways: