commit 231609743ff90c2f70a79d2f1fe28d23ea85df34
Author: Scott Kostyshak <[email protected]>
Date: Thu Oct 29 22:11:11 2015 -0400
More updates for the documentation on tests
- general cleanup
- add some more useful commands
- specify how to configure the URL tests
Thanks to Kornel for the helpful suggestions.
diff --git a/lib/doc/Development.lyx b/lib/doc/Development.lyx
index 0fbf144..d02aa68 100644
--- a/lib/doc/Development.lyx
+++ b/lib/doc/Development.lyx
@@ -734,7 +734,7 @@ The tex2lyx tests can be run by the commands
status collapsed
\begin_layout Plain Layout
-ctest
+ctest -R tex2lyx
\end_layout
\end_inset
@@ -1068,8 +1068,7 @@ Running the tests
\end_layout
\begin_layout Standard
-To run all of the export tests, in the build directory simply run the command
-
+To run all tests, in the build directory simply run the command
\begin_inset Flex Code
status collapsed
@@ -1101,6 +1100,36 @@ status collapsed
\end_inset
is a regular expression that matches test names.
+ To run only the export tests, you can use
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+ctest -L export
+\end_layout
+
+\end_inset
+
+.
+ For the list of test categories available in addition to
+\begin_inset Quotes eld
+\end_inset
+
+export
+\begin_inset Quotes erd
+\end_inset
+
+, run
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+ctest --print-labels
+\end_layout
+
+\end_inset
+
+.
It is often useful to list the tests without running them (e.g.
if you want to know how many tests there are or whether your
\begin_inset Flex Code
@@ -1191,18 +1220,9 @@ ctest -j8
status collapsed
\begin_layout Plain Layout
-ctest -
-\begin_inset ERT
-status open
-
-\begin_layout Plain Layout
-
-{}
-\end_layout
-
-\end_inset
-
--rerun-failed
+ctest \SpecialChar nobreakdash
+\SpecialChar nobreakdash
+rerun-failed
\end_layout
\end_inset
@@ -1518,10 +1538,33 @@ URL tests
\end_layout
\begin_layout Standard
-These tests are extremely fragile and a failed URL test should not be taken
- too seriously.
- They are useful for finding broken links in our documentation files.
- These must be enabled at configure.
+The URL tests are enabled with the
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+-DLYX_ENABLE_URLTESTS=ON
+\end_layout
+
+\end_inset
+
+ CMake flag and are useful for finding broken links in our documentation
+ files.
+ If a URL test fails, to see which link in particular was reported as broken,
+ see the output in
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+LastTest.log
+\end_layout
+
+\end_inset
+
+.
+ These tests are extremely fragile (e.g.
+ a test can depend on your Internet connection) and a failed URL test should
+ not be taken too seriously.
\end_layout
\begin_layout Chapter
