summaryrefslogtreecommitdiff
path: root/share/cmake-3.18/Help/prop_test/COST.rst
diff options
context:
space:
mode:
Diffstat (limited to 'share/cmake-3.18/Help/prop_test/COST.rst')
-rw-r--r--share/cmake-3.18/Help/prop_test/COST.rst14
1 files changed, 14 insertions, 0 deletions
diff --git a/share/cmake-3.18/Help/prop_test/COST.rst b/share/cmake-3.18/Help/prop_test/COST.rst
new file mode 100644
index 0000000..9300d7b
--- /dev/null
+++ b/share/cmake-3.18/Help/prop_test/COST.rst
@@ -0,0 +1,14 @@
+COST
+----
+
+This property describes the cost of a test. When parallel testing is
+enabled, tests in the test set will be run in descending order of cost.
+Projects can explicitly define the cost of a test by setting this property
+to a floating point value.
+
+When the cost of a test is not defined by the project,
+:manual:`ctest <ctest(1)>` will initially use a default cost of ``0``.
+It computes a weighted average of the cost each time a test is run and
+uses that as an improved estimate of the cost for the next run. The more
+a test is re-run in the same build directory, the more representative the
+cost should become.