[Cmake-commits] CMake branch, master, updated. v3.10.1-665-g08d574e

[Kitware Robot]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "CMake".

The branch, master has been updated
       via  08d574e9d7b17971468aa0399d950edb147b57ca (commit)
       via  d15f199c142226cde18514b1ee1495c6a40e1633 (commit)
      from  deaa19cfedfb3d3c51fae64df809aa01fff1f55c (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
https://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=08d574e9d7b17971468aa0399d950edb147b57ca
commit 08d574e9d7b17971468aa0399d950edb147b57ca
Merge: deaa19c d15f199
Author:     Craig Scott <craig.scott at crascit.com>
AuthorDate: Thu Dec 21 11:36:05 2017 +0000
Commit:     Kitware Robot <kwrobot at kitware.com>
CommitDate: Thu Dec 21 06:36:21 2017 -0500

    Merge topic 'ctest-update-timing-summary-manual'
    
    d15f199c CTest: Expand 'Label and Subproject Summary' section of manual
    
    Acked-by: Kitware Robot <kwrobot at kitware.com>
    Merge-request: !1598


https://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=d15f199c142226cde18514b1ee1495c6a40e1633
commit d15f199c142226cde18514b1ee1495c6a40e1633
Author:     Betsy McPhail <betsy.mcphail at kitware.com>
AuthorDate: Fri Dec 15 12:49:17 2017 -0500
Commit:     Betsy McPhail <betsy.mcphail at kitware.com>
CommitDate: Fri Dec 15 12:49:17 2017 -0500

    CTest: Expand 'Label and Subproject Summary' section of manual

diff --git a/Help/manual/ctest.1.rst b/Help/manual/ctest.1.rst
index d9af3bc..a04c403 100644
--- a/Help/manual/ctest.1.rst
+++ b/Help/manual/ctest.1.rst
@@ -330,11 +330,39 @@ associated with the tests run. The label time summary will not include labels
 that are mapped to subprojects.
 
 When the :prop_test:`PROCESSORS` test property is set, CTest will display a
-weighted test timing result in label and subproject summaries. The wall clock
-time for the test run will be multiplied by this property to give a better
-idea of how much cpu resource CTest allocated for the test. The time is
+weighted test timing result in label and subproject summaries. The time is
 reported with `sec*proc` instead of just `sec`.
 
+The weighted time summary reported for each label or subproject j is computed
+as::
+
+  Weighted Time Summary for Label/Subproject j =
+      sum(raw_test_time[j,i] * num_processors[j,i], i=1...num_tests[j])
+
+  for labels/subprojects j=1...total
+
+where:
+
+* raw_test_time[j,i]: Wall-clock time for the ith test for the jth label or
+  subproject
+* num_processors[j,i]: Value of the CTest PROCESSORS property for the ith test
+  for the jth label or subproject
+* num_tests[j]: Number of tests associated with the jth label or subproject
+* total: Total number of labels or subprojects that have at least one test run
+
+Therefore, the weighted time summary for each label or subproject represents
+the amount of time that CTest gave to run the tests for each label or
+subproject and gives a good representation of the total expense of the tests
+for each label or subproject when compared to other labels or subprojects.
+
+For example, if "SubprojectA" showed "100 sec*proc" and "SubprojectB" showed
+"10 sec*proc", then CTest allocated approximately  10 times the CPU/core time
+to run the tests for "SubprojectA" than for "SubprojectB" (e.g. so if effort
+is going to be expended to reduce the cost of the test suite for the whole
+project, then reducing the cost of the test suite for "SubprojectA" would
+likely have a larger impact than effort to reduce the cost of the test suite
+for "SubprojectB").
+
 .. _`Build and Test Mode`:
 
 Build and Test Mode

-----------------------------------------------------------------------

Summary of changes:
 Help/manual/ctest.1.rst |   34 +++++++++++++++++++++++++++++++---
 1 file changed, 31 insertions(+), 3 deletions(-)


hooks/post-receive
-- 
CMake