mirror/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2026-01-03 12:19:41 -06:00
Code Issues Packages Projects Releases Wiki Activity

Help: Clarify the default value for test property COST

Browse Source 
Co-Authored-By: Steve Mokris <smokris@softpixel.com>
This commit is contained in:
Craig Scott
2019-05-29 20:57:52 -04:00
parent 067a4f484b
commit 774102aaec
1 changed files with 10 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
Help/prop_test/COST.rst
View File

@@ -1,8 +1,14 @@
COST
----
Set this to a floating point value. Tests in a test set will be run
in descending order of 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.
This property describes the cost of a test. You can explicitly set
this value; tests with higher ``COST`` values will run first.
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.