From: hwangcc23 Date: Sun, 21 May 2017 15:08:27 +0000 (+0800) Subject: Update testsuite docs X-Git-Tag: 4.14~31^2 X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=bbfdcfddfeffded9c9f38797d923e11e1278aa79;p=i3%2Fi3 Update testsuite docs After moved to autotools, the method to run the i3 testsuite is changed. Update the testsuite document to reflect the change. --- diff --git a/docs/testsuite b/docs/testsuite index 71c6a427..db98da13 100644 --- a/docs/testsuite +++ b/docs/testsuite @@ -114,7 +114,18 @@ machines without a powerful video card. .Example invocation of complete-run.pl+ --------------------------------------- -$ cd ~/i3/testcases +$ cd ~/i3 + +$ autoreconf -fi + +$ mkdir -p build && cd build + +$ ../configure + +$ make -j8 +# output omitted because it is very long + +$ cd testcases $ ./complete-run.pl # output omitted because it is very long @@ -160,6 +171,41 @@ $ ./complete-run.pl --parallel=1 --keep-xserver-output This will show the output of Xephyr, which is the X server implementation we use for testing. +===== make command: make check +Make check runs the i3 testsuite. +You can still use ./testcases/complete-run.pl to get the interactive progress output. + +.Example invocation of make check+ +--------------------------------------- +$ cd ~/i3 + +$ autoreconf -fi + +$ mkdir -p build && cd build + +$ ../configure + +$ make -j8 +# output omitted because it is very long + +$ make check +# output omitted because it is very long +PASS: testcases/complete-run.pl +============================================================================ +Testsuite summary for i3 4.13 +============================================================================ +# TOTAL: 1 +# PASS: 1 +# SKIP: 0 +# XFAIL: 0 +# FAIL: 0 +# XPASS: 0 +# ERROR: 0 +============================================================================ + +$ less test-suite.log +---------------------------------------- + ==== Coverage testing Coverage testing is possible with +lcov+, the front-end for GCC's coverage