]> git.sur5r.net Git - i3/i3.github.io/blobdiff - docs/testsuite.html
update docs for 4.14
[i3/i3.github.io] / docs / testsuite.html
index 9fa9202743fd9881c9cc376bff7074c750c3e51f..35631251d65c3a92b012d9227bd312f6fa90106f 100644 (file)
@@ -146,6 +146,8 @@ used to install the testsuite. Many users prefer to use the more modern
 <div class="content">\r
 <pre><tt>$ cd ~/i3/testcases\r
 $ sudo apt-get install cpanminus\r
+$ sudo cpanm .\r
+$ cd ~/i3/AnyEvent-I3\r
 $ sudo cpanm .</tt></pre>\r
 </div></div>\r
 <div class="paragraph"><p>If you don’t want to use cpanminus for some reason, the same works with cpan:</p></div>\r
@@ -153,6 +155,8 @@ $ sudo cpanm .</tt></pre>
 <div class="title">Installing testsuite dependencies using cpan</div>\r
 <div class="content">\r
 <pre><tt>$ cd ~/i3/testcases\r
+$ sudo cpan .\r
+$ cd ~/i3/AnyEvent-I3\r
 $ sudo cpan .</tt></pre>\r
 </div></div>\r
 <div class="paragraph"><p>In case you don’t have root permissions, you can also install into your home\r
@@ -174,9 +178,20 @@ the tests without an X session with Xvfb, such as with <tt>xvfb-run
 ./complete-run</tt>. This will also speed up the tests significantly especially on\r
 machines without a powerful video card.</p></div>\r
 <div class="listingblock">\r
-<div class="title">Example invocation of complete-run.pl+</div>\r
+<div class="title">Example invocation of <tt>complete-run.pl</tt></div>\r
 <div class="content">\r
-<pre><tt>$ cd ~/i3/testcases\r
+<pre><tt>$ cd ~/i3\r
+\r
+$ autoreconf -fi\r
+\r
+$ mkdir -p build &amp;&amp; cd build\r
+\r
+$ ../configure\r
+\r
+$ make -j8\r
+# output omitted because it is very long\r
+\r
+$ cd testcases\r
 \r
 $ ./complete-run.pl\r
 # output omitted because it is very long\r
@@ -219,6 +234,42 @@ $ less latest/i3-log-for-04-floating.t</tt></pre>
 </div></div>\r
 <div class="paragraph"><p>This will show the output of Xephyr, which is the X server implementation we\r
 use for testing.</p></div>\r
+<div class="sect4">\r
+<h5 id="_make_command_tt_make_check_tt">make command: <tt>make check</tt></h5>\r
+<div class="paragraph"><p>Make check runs the i3 testsuite.\r
+You can still use ./testcases/complete-run.pl to get the interactive progress output.</p></div>\r
+<div class="listingblock">\r
+<div class="title">Example invocation of <tt>make check</tt></div>\r
+<div class="content">\r
+<pre><tt>$ cd ~/i3\r
+\r
+$ autoreconf -fi\r
+\r
+$ mkdir -p build &amp;&amp; cd build\r
+\r
+$ ../configure\r
+\r
+$ make -j8\r
+# output omitted because it is very long\r
+\r
+$ make check\r
+# output omitted because it is very long\r
+PASS: testcases/complete-run.pl\r
+============================================================================\r
+Testsuite summary for i3 4.13\r
+============================================================================\r
+# TOTAL: 1\r
+# PASS:  1\r
+# SKIP:  0\r
+# XFAIL: 0\r
+# FAIL:  0\r
+# XPASS: 0\r
+# ERROR: 0\r
+============================================================================\r
+\r
+$ less test-suite.log</tt></pre>\r
+</div></div>\r
+</div>\r
 </div>\r
 <div class="sect3">\r
 <h4 id="_coverage_testing">3.2.2. Coverage testing</h4>\r