Merge subtree 'rules' into rules-cc

1 files changed, 12 insertions, 2 deletions

diff --git a/rules/shell/test/RULES b/rules/shell/test/RULES
index b3d757a..25d2493 100644
--- a/rules/shell/test/RULES
+++ b/rules/shell/test/RULES
@@ -24,6 +24,11 @@
       , "If the configuration variable RUNS_PER_TEST is set, the environment"
       , "variable TEST_RUN_NUMBER will also be set to the number of the attempt,"
       , "counting from 0."
+      , ""
+      , "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 shell test environment can be modified globally."
       ]
     , "name":
       [ "A name for the test, used in reporting, as well as for staging"
@@ -43,6 +48,12 @@
     { "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."
+      , ""
+      , "The individual test runs will be summarized by the implict dependency"
+      , "on the target \"summarizer\". By setting this target in the target"
+      , "in the target layer of this rues repository (instead of letting it"
+      , "default to the respective file) the layout of the summary can be"
+      , "changed globally."
       ]
     , "TEST_ENV": ["Additional environment for executing the test runner."]
     , "TIMEOUT_SCALE":
@@ -76,8 +87,7 @@
     , "As the built-in \"install\" rule only takes the runfiles of its \"deps\""
     , "argument, this gives an easy way of defining test suites."
     ]
-  , "implicit":
-    {"runner": ["test_runner.sh"], "summarizer": ["test_summary.py"]}
+  , "implicit": {"runner": ["runner"], "summarizer": ["summarizer"]}
   , "imports":
     { "test-result": "test-result"
     , "action": "test-action"