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 2f71706bfb50c6bd0bc0ffae3c74c710f18f249b..cbf4f5b3b5f943285729fd54118450b7ad743679 100644 (file)
--- 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.