summaryrefslogtreecommitdiffstats
path: root/Help/command
diff options
context:
space:
mode:
authorBen Boeckel <ben.boeckel@kitware.com>2023-12-09 15:17:16 (GMT)
committerBen Boeckel <ben.boeckel@kitware.com>2023-12-09 15:17:16 (GMT)
commit8540520902e6acd0cfe0041a234bd612c6a46c7f (patch)
tree7a02fa407b018ac9d105a0cd23a47ef652e6d264 /Help/command
parentfabfaf0aa098f9d5b385713a454825a1ff8bb1f7 (diff)
downloadCMake-8540520902e6acd0cfe0041a234bd612c6a46c7f.zip
CMake-8540520902e6acd0cfe0041a234bd612c6a46c7f.tar.gz
CMake-8540520902e6acd0cfe0041a234bd612c6a46c7f.tar.bz2
Help/create_test_sourcelist: reflow prose
Diffstat (limited to 'Help/command')
-rw-r--r--Help/command/create_test_sourcelist.rst35
1 files changed, 17 insertions, 18 deletions
diff --git a/Help/command/create_test_sourcelist.rst b/Help/command/create_test_sourcelist.rst
index 77e37c5..f6106d0 100644
--- a/Help/command/create_test_sourcelist.rst
+++ b/Help/command/create_test_sourcelist.rst
@@ -10,21 +10,20 @@ Create a test driver and source list for building test programs.
EXTRA_INCLUDE include.h
FUNCTION function)
-A test driver is a program that links together many small tests into a
-single executable. This is useful when building static executables
-with large libraries to shrink the total required size. The list of
-source files needed to build the test driver will be in
-``sourceListName``. ``driverName`` is the name of the test driver program.
-The rest of the arguments consist of a list of test source files, can
-be semicolon separated. Each test source file should have a function
-in it that is the same name as the file with no extension (foo.cxx
-should have int foo(int, char*[]);) ``driverName`` will be able to call
-each of the tests by name on the command line. If ``EXTRA_INCLUDE`` is
-specified, then the next argument is included into the generated file.
-If ``FUNCTION`` is specified, then the next argument is taken as a
-function name that is passed a pointer to ac and av. This can be used
-to add extra command line processing to each test. The
-``CMAKE_TESTDRIVER_BEFORE_TESTMAIN`` cmake variable can be set to
-have code that will be placed directly before calling the test main function.
-``CMAKE_TESTDRIVER_AFTER_TESTMAIN`` can be set to have code that
-will be placed directly after the call to the test main function.
+A test driver is a program that links together many small tests into a single
+executable. This is useful when building static executables with large
+libraries to shrink the total required size. The list of source files needed
+to build the test driver will be in ``sourceListName``. ``driverName`` is the
+name of the test driver program. The rest of the arguments consist of a list
+of test source files, can be semicolon separated. Each test source file
+should have a function in it that is the same name as the file with no
+extension (foo.cxx should have int foo(int, char*[]);) ``driverName`` will be
+able to call each of the tests by name on the command line. If
+``EXTRA_INCLUDE`` is specified, then the next argument is included into the
+generated file. If ``FUNCTION`` is specified, then the next argument is taken
+as a function name that is passed a pointer to ac and av. This can be used to
+add extra command line processing to each test. The
+``CMAKE_TESTDRIVER_BEFORE_TESTMAIN`` cmake variable can be set to have code
+that will be placed directly before calling the test main function.
+``CMAKE_TESTDRIVER_AFTER_TESTMAIN`` can be set to have code that will be
+placed directly after the call to the test main function.