Преглед на файлове

Help: Add pre-test to prose for gtest_discover_tests()

The prose previously gave the impression that discovery was always done
as a post-build operation, but later in the documentation the
DISCOVERY_MODE option is explained where pre-test can also be specified.
Update the earlier prose to mention both methods equally.
Craig Scott преди 1 година
родител
ревизия
9f1703530b
променени са 1 файла, в които са добавени 9 реда и са изтрити 9 реда
  1. 9 9
      Modules/GoogleTest.cmake

+ 9 - 9
Modules/GoogleTest.cmake

@@ -162,15 +162,15 @@ same as the Google Test name (i.e. ``suite.testcase``); see also
 
   .. versionadded:: 3.10
 
-  ``gtest_discover_tests()`` sets up a post-build command on the test executable
-  that generates the list of tests by parsing the output from running the test
-  with the ``--gtest_list_tests`` argument.  Compared to the source parsing
-  approach of :command:`gtest_add_tests`, this ensures that the full list of
-  tests, including instantiations of parameterized tests, is obtained.  Since
-  test discovery occurs at build time, it is not necessary to re-run CMake when
-  the list of tests changes.
-  However, it requires that :prop_tgt:`CROSSCOMPILING_EMULATOR` is properly set
-  in order to function in a cross-compiling environment.
+  ``gtest_discover_tests()`` sets up a post-build or pre-test command on the
+  test executable that generates the list of tests by parsing the output from
+  running the test executable with the ``--gtest_list_tests`` argument.
+  Compared to the source parsing approach of :command:`gtest_add_tests`,
+  this ensures that the full list of tests, including instantiations of
+  parameterized tests, is obtained.  Since test discovery occurs at build
+  or test time, it is not necessary to re-run CMake when the list of tests
+  changes.  However, it requires that :prop_tgt:`CROSSCOMPILING_EMULATOR`
+  is properly set in order to function in a cross-compiling environment.
 
   Additionally, setting properties on tests is somewhat less convenient, since
   the tests are not available at CMake time.  Additional test properties may be