Document sebastianbergmann/phpunit#4501

Author: sebastianbergmann

src/cli-options.rst

@@ -134,6 +134,9 @@ Execution
 ``--strict-coverage``
    Enforces strict mode for code coverage metadata. Tests that execute code not declared in their ``#[Covers*]`` or ``#[Uses*]`` metadata will be marked as risky.
 
+``--require-coverage-contribution``
+   Marks tests as risky when they have code coverage targets but do not execute any line of the targeted code.
+
 ``--strict-global-state``
    Enforces strict checking of global state changes. Tests that modify global state (such as global variables, super-globals, or static properties) will be marked as risky.
 

src/configuration.rst

@@ -356,6 +356,15 @@ Possible values: ``true`` or ``false`` (default: ``false``)
 
 This attribute configures whether PHPUnit should mark a test as risky when it executes code that is not specified to be covered or used using an attribute.
 
+.. _appendixes.configuration.phpunit.requireCoverageContribution:
+
+The ``requireCoverageContribution`` Attribute
+---------------------------------------------
+
+Possible values: ``true`` or ``false`` (default: ``false``)
+
+This attribute configures whether PHPUnit should mark a test as risky when it has code coverage targets but does not execute any line of the targeted code.
+
 .. _appendixes.configuration.phpunit.enforceTimeLimit:
 
 The ``enforceTimeLimit`` Attribute

src/risky-tests.rst

@@ -58,6 +58,20 @@ metadata (such as ``CoversClass``, ``CoversMethod``, ``CoversFunction``, ``Cover
 Unlike the strict coverage check described above, this check is performed regardless of the test's size (``#[Small]``, ``#[Medium]``, or ``#[Large]``).
 
 
+.. _risky-tests.no-code-coverage-contribution:
+
+No Code Coverage Contribution
+=============================
+
+PHPUnit can be strict about tests that do not contribute to code coverage. This check
+can be enabled by using the ``--require-coverage-contribution`` option on
+the :ref:`command-line <appendixes.cli-options.execution>` or by setting
+``requireCoverageContribution="true"`` in PHPUnit's
+:ref:`XML configuration file <appendixes.configuration>`.
+
+A test that has :ref:`code coverage targets <code-coverage.targeting-units-of-code>` but does not execute any line of the targeted code will be considered risky when this check is enabled.
+
+
 .. _risky-tests.output-during-test-execution:
 
 Output During Test Execution