Index: third_party/coverage-3.6/doc/source.rst |
diff --git a/third_party/coverage-3.6/doc/source.rst b/third_party/coverage-3.6/doc/source.rst |
deleted file mode 100644 |
index aafb976cff2a518e5259832aa089d883b1abb1c6..0000000000000000000000000000000000000000 |
--- a/third_party/coverage-3.6/doc/source.rst |
+++ /dev/null |
@@ -1,74 +0,0 @@ |
-.. _source: |
- |
-======================= |
-Specifying source files |
-======================= |
- |
-:history: 20100725T172000, new in 3.4 |
- |
- |
-When coverage.py is running your program and measuring its execution, it needs |
-to know what code to measure and what code not to. Measurement imposes a speed |
-penalty, and the collected data must be stored in memory and then on disk. |
-More importantly, when reviewing your coverage reports, you don't want to be |
-distracted with modules that aren't your concern. |
- |
-Coverage.py has a number of ways you can focus it in on the code you care |
-about. |
- |
- |
-.. _source_execution: |
- |
-Execution |
---------- |
- |
-When running your code, the ``coverage run`` command will by default measure |
-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. 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 |
-values). ``--include`` is a list of filename patterns. If specified, only files |
-matching those patterns will be measured. ``--omit`` is also a list of filename |
-patterns, specifying files not to measure. If both ``include`` and ``omit`` |
-are specified, first the set of files is reduced to only those that match the |
-include patterns, then any files that match the omit pattern are removed from |
-the set. |
- |
-The ``include`` and ``omit`` filename patterns follow typical shell syntax: |
-``*`` matches any number of characters and ``?`` matches a single character. |
-Patterns that start with a wildcard character are used as-is, other patterns |
-are interpreted relative to the current directory. |
- |
-The ``source``, ``include``, and ``omit`` values all work together to determine |
-the source that will be measured. |
- |
- |
-.. _source_reporting: |
- |
-Reporting |
---------- |
- |
-Once your program is measured, you can specify the source files you want |
-reported. Usually you want to see all the code that was measured, but if you |
-are measuring a large project, you may want to get reports for just certain |
-parts. |
- |
-The report commands (``report``, ``html``, ``annotate``, and ``xml``) all take |
-optional ``modules`` arguments, and ``--include`` and ``--omit`` switches. The |
-``modules`` arguments specify particular modules to report on. The ``include`` |
-and ``omit`` values are lists of filename patterns, just as with the ``run`` |
-command. |
- |
-Remember that the reporting commands can only report on the data that has been |
-collected, so the data you're looking for may not be in the data available for |
-reporting. |
- |
-Note that these are ways of specifying files to measure. You can also exclude |
-individual source lines. See :ref:`excluding` for details. |