summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/cmd.rst3
-rw-r--r--doc/help/combine.rst2
-rw-r--r--doc/python-coverage.1.txt6
3 files changed, 7 insertions, 4 deletions
diff --git a/doc/cmd.rst b/doc/cmd.rst
index f6087fec..2b2086b1 100644
--- a/doc/cmd.rst
+++ b/doc/cmd.rst
@@ -287,6 +287,9 @@ setting to store relative file paths (see :ref:`relative_files
If any of the data files can't be read, coverage.py will print a warning
indicating the file and the problem.
+The original input data files are deleted once they've been combined. If you
+want to keep those files, use the ``--keep`` command-line option.
+
.. include:: help/combine.rst
diff --git a/doc/help/combine.rst b/doc/help/combine.rst
index c35d5b93..7926e9cd 100644
--- a/doc/help/combine.rst
+++ b/doc/help/combine.rst
@@ -13,7 +13,7 @@
Options:
-a, --append Append coverage data to .coverage, otherwise it starts
clean each time.
- --keep Keep combined coverage files, otherwise they are deleted.
+ --keep Keep original coverage files, otherwise they are deleted.
--debug=OPTS Debug options, separated by commas. [env: COVERAGE_DEBUG]
-h, --help Get help on this command.
--rcfile=RCFILE Specify configuration file. By default '.coveragerc',
diff --git a/doc/python-coverage.1.txt b/doc/python-coverage.1.txt
index 10a8927a..00c243de 100644
--- a/doc/python-coverage.1.txt
+++ b/doc/python-coverage.1.txt
@@ -108,8 +108,8 @@ COMMAND REFERENCE
Combine data from multiple coverage files collected with ``run -p``.
The combined results are written to a single file representing the
- union of the data.
- Unless --keep is provided the combined coverage files are deleted.
+ union of the data. Unless --keep is provided the original input
+ coverage files are deleted.
If `PATH` is specified, they are files or directories containing data to
be combined.
@@ -121,7 +121,7 @@ COMMAND REFERENCE
time.
\--keep
- Keep combined coverage file.
+ Keep original coverage data files.
**debug** `TOPIC` ...