diff options
Diffstat (limited to 'Help/prop_test/COST.rst')
| -rw-r--r-- | Help/prop_test/COST.rst | 13 |
1 files changed, 10 insertions, 3 deletions
diff --git a/Help/prop_test/COST.rst b/Help/prop_test/COST.rst index 3236a0295..9300d7b27 100644 --- a/Help/prop_test/COST.rst +++ b/Help/prop_test/COST.rst @@ -1,7 +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. |