summaryrefslogtreecommitdiff
path: root/doc/source.rst
diff options
context:
space:
mode:
authorNed Batchelder <ned@nedbatchelder.com>2010-09-03 23:15:20 -0400
committerNed Batchelder <ned@nedbatchelder.com>2010-09-03 23:15:20 -0400
commit8153341439f1eddddad18ee6ca8ca10a88549129 (patch)
treed9e6c8a5d9c7e642157a2bf15e1d7a659969c843 /doc/source.rst
parent9da5c35a04dd117dda5f868ab1057b2f0603708b (diff)
downloadpython-coveragepy-git-8153341439f1eddddad18ee6ca8ca10a88549129.tar.gz
Now completely unexecuted source files can be included in reporting. Specifying --source tells coverage.py where to search for files that haven't been executed.
Diffstat (limited to 'doc/source.rst')
-rw-r--r--doc/source.rst5
1 files changed, 3 insertions, 2 deletions
diff --git a/doc/source.rst b/doc/source.rst
index e39090a4..3f0a1566 100644
--- a/doc/source.rst
+++ b/doc/source.rst
@@ -28,7 +28,9 @@ all code, unless it is part of the Python standard library.
You can specify source to measure with the ``--source`` command-line switch,
or the ``[run] source`` configuration value. The value is a list of directories
or package names. If specified, only source inside these directories or
-packages will be measured.
+packages will be measured. Specifying the source option also enables
+coverage.py to report on unexecuted files, since it can search the source tree
+for files that haven't been measured at all.
You can further fine-tune coverage.py's attention with the ``--include`` and
``--omit`` switches (or ``[run] include`` and ``[run] omit`` configuration
@@ -72,4 +74,3 @@ reporting.
Note that these are ways of specifying files to measure. You can also exclude
individual source lines. See :ref:`excluding` for details.
-