summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPeter Hutterer <peter.hutterer@who-t.net>2015-05-20 11:04:13 +1000
committerPeter Hutterer <peter.hutterer@who-t.net>2015-05-22 08:45:35 +1000
commitfcd1cbe5e5dfdb66fd1136273ba15a66cf40caa5 (patch)
tree82090f4d6ec4148b68495d67506e8e24fe761e76 /doc
parentf3947c0eb9ae61b1dc0d8bc8e8050c75a6e98543 (diff)
doc: drop leftovers of Check's selective test running
CK_RUN_CASE and CK_RUN_SUITE still work because we're still using check underneath, but it's better to use the arguments. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
Diffstat (limited to 'doc')
-rw-r--r--doc/test-suite.dox18
1 files changed, 4 insertions, 14 deletions
diff --git a/doc/test-suite.dox b/doc/test-suite.dox
index 83cae24b..30dd1579 100644
--- a/doc/test-suite.dox
+++ b/doc/test-suite.dox
@@ -25,10 +25,10 @@ resulting `/dev/input/eventX` nodes. Some tests require temporary udev rules.
@section test-filtering Selective running of tests
-Check enables tests to be grouped into suites and test cases, litest uses
-test suites as a general feature-specific grouping (e.g. "touchpad:tap") and
-instantiates one test case per device. The --list flag shows the list of
-suites and tests.
+litest's tests are grouped by test groups and devices. A test group is e.g.
+"touchpad:tap" and incorporates all tapping-related tests for touchpads.
+Each test function is (usually) run with one or more specific devices.
+The `--list` commandline argument shows the list of suites and tests.
@code
$ ./test/test-device --list
device:wheel:
@@ -52,16 +52,6 @@ uinput by litest. The "no device" entry signals that litest does not
instantiate a uinput device for a specific test (though the test itself may
instantiate one).
-Check provides two filters through environment variables: <b>CK_RUN_SUITE</b>
-and <b>CK_RUN_CASE</b>. They may be used independently or combined to narrow
-down the set of tests to run. For example:
-
-@code
-$ CK_RUN_SUITE="device:wheel" ./test/test-device
-$ CK_RUN_CASE="wheel only" ./test/test-device
-$ CK_RUN_SUITE="device:wheel" CK_RUN_CASE="wheel only" ./test/test-device
-@endcode
-
The `--filter-test` argument enables selective running of tests through
basic shell-style function name matching. For example: