From fd66f69c1997fb9dc38a7891ec59210ecbb09558 Mon Sep 17 00:00:00 2001 From: David Szotten Date: Sun, 14 Oct 2018 18:50:06 +0100 Subject: [PATCH] draft doc --- doc/en/cache.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/doc/en/cache.rst b/doc/en/cache.rst index 08f204655..245edfc1b 100644 --- a/doc/en/cache.rst +++ b/doc/en/cache.rst @@ -260,3 +260,9 @@ by adding the ``--cache-clear`` option like this:: This is recommended for invocations from Continuous Integration servers where isolation and correctness is more important than speed. + + +Stepwise +-------- + +As an alternative to ``--lf -x``, especially for cases where you expect a large part of the test suite will fail, ``--sw``, ``--stepwise`` allows you to fix them one at a time. The test suite will run until the first failure and then stop. At the next invocation, tests will continue from the last failing test and then run until the next failing test. You may use the ``--stepwise-skip`` option to ignore one failing test and stop the test execution on the second failing test instead. This is useful if you get stuck on a failing test and just want to ignore it until later.