From: Scott Kostyshak <skostysh@lyx.org>
Date: Sun, 31 Jan 2016 20:06:23 +0000 (-0500)
Subject: Document need to use same subset if --rerun-failed
X-Git-Tag: 2.2.0beta1~29^2
X-Git-Url: https://git.lyx.org/gitweb/?a=commitdiff_plain;h=d5694318efd1f70a258a4c83b0f7c6096d7173cd;p=features.git

Document need to use same subset if --rerun-failed

When running the tests with ctest, --rerun-failed can be used to run
the tests that failed on the previous run. However, the same subset
must be specified because it is the test numbers that are used to
index which tests failed on the previous run. For example, it would
be incorrect to do the following:

  ctest -R export
  ctest --rerun-failed

The following is correct:

  ctest -R export
  ctest -R export --rerun-failed
---

diff --git a/lib/doc/Development.lyx b/lib/doc/Development.lyx
index 2f71706bfb..cbf4f5b3b5 100644
--- a/lib/doc/Development.lyx
+++ b/lib/doc/Development.lyx
@@ -2062,7 +2062,6 @@ We are still working on getting the tests to run in parallel.
  pass when run sequentially.
  A reasonable approach is to first run the tests in parallel and then run
  the failed tests sequentially.
- 
 \end_layout
 
 \begin_layout Standard
@@ -2097,6 +2096,35 @@ rerun-failed
 
 \end_layout
 
+\begin_layout Standard
+When specifying a subset of the tests (e.g.
+ using 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+\SpecialChar nobreakdash
+R <pattern>
+\end_layout
+
+\end_inset
+
+), the same subset must be specified when using the 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+\SpecialChar nobreakdash
+\SpecialChar nobreakdash
+rerun-failed
+\end_layout
+
+\end_inset
+
+ option because it is the test numbers that are used to index which tests
+ failed on the previous run.
+\end_layout
+
 \begin_layout Standard
 \noindent
 Note that some tests cannot be run in parallel.