Merge subtree 'rules' into rules-cc

5 files changed, 24 insertions, 4 deletions

diff --git a/rules/CC/auto/RULES b/rules/CC/auto/RULES
index 0e156c9..860db01 100644
--- a/rules/CC/auto/RULES
+++ b/rules/CC/auto/RULES
@@ -1015,6 +1015,11 @@
     , "target configuration. In the usual case, a target using this rule is"
     , "configured by depending on it from a target that uses the built-in"
     , "\"configure\" rule."
+    , ""
+    , "The actual generation of the header file from the template"
+    , "is done by the implicit dependency on the \"runner\" target which"
+    , "can be changed globally by setting this target in the"
+    , "target layer of this repository."
     ]
   , "field_doc":
     { "output":
@@ -1045,7 +1050,7 @@
     , "last": "last_list_entry"
     , "stage_singleton_field": ["", "stage_singleton_field"]
     }
-  , "implicit": {"runner": ["config_runner.py"]}
+  , "implicit": {"runner": ["runner"]}
   , "expression":
     { "type": "let*"
     , "bindings":
diff --git a/rules/CC/auto/TARGETS b/rules/CC/auto/TARGETS
new file mode 100644
index 0000000..0967ef4
--- /dev/null
+++ b/rules/CC/auto/TARGETS
@@ -0,0 +1 @@
+{}
diff --git a/rules/CC/auto/config_runner.py b/rules/CC/auto/runner
index f938c27..f938c27 100755
--- a/rules/CC/auto/config_runner.py
+++ b/rules/CC/auto/runner
diff --git a/rules/CC/test/RULES b/rules/CC/test/RULES
index a1f4bfb..08c058c 100644
--- a/rules/CC/test/RULES
+++ b/rules/CC/test/RULES
@@ -32,8 +32,8 @@
     ]
   , "implicit":
     { "defaults": [["./", "..", "defaults"]]
-    , "runner": ["test_runner.py"]
-    , "summarizer": [["./", "../../shell/test", "test_summary.py"]]
+    , "runner": ["runner"]
+    , "summarizer": [["./", "../../shell/test", "summarizer"]]
     }
   , "field_doc":
     { "name":
@@ -42,7 +42,18 @@
       , "Used to name the test binary as well as for staging the test result"
       ]
     , "args": ["Command line arguments for the test binary"]
-    , "srcs": ["The sources of the test binary"]
+    , "srcs":
+      [ "The sources of the test binary"
+      , ""
+      , "The resulting test binary in an environment where it can assume"
+      , "that the environment variable TEST_TMPDIR points to a"
+      , "director that may be used exclusively by this test."
+      , ""
+      , "This running of the test is carried out by the implicit dependency"
+      , "on the target \"runner\". By setting this target in the target layer"
+      , "of this rues repository (instead of letting it default to the"
+      , "respective file), the C/C++ test environment can be modified globally."
+      ]
     , "private-hdrs":
       [ "Any additional header files that need to be present when compiling"
       , "the test binary."
@@ -100,6 +111,9 @@
     , "RUNS_PER_TEST":
       [ "The number of times the test should be run in order to detect flakyness."
       , "If set, no test action will be taken from cache."
+      , ""
+      , "Test runs are summarized by the [\"shell/test\", \"summarizer\"] that"
+      , "is also used by shell tests."
       ]
     , "TARGET_ARCH":
       [ "The architecture to build the test for."
diff --git a/rules/CC/test/test_runner.py b/rules/CC/test/runner
index 0647621..0647621 100755
--- a/rules/CC/test/test_runner.py
+++ b/rules/CC/test/runner