From: Ján Tomko <jtomko@redhat.com>
Date: Fri, 18 Oct 2019 21:03:27 +0000 (+0200)
Subject: docs: hacking: demonstrate the powers of VIR_TEST_RANGE
X-Git-Url: http://xenbits.xensource.com/gitweb?a=commitdiff_plain;h=fe9b3e1cdcc79b60ac99d583ee51c52bfa691d0b;p=libvirt.git

docs: hacking: demonstrate the powers of VIR_TEST_RANGE

Mention a more complex example.

Invoke the test without 'make' since the mentioned example
does not seem to be working anymore.

Signed-off-by: Ján Tomko <jtomko@redhat.com>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
Reviewed-by: Andrea Bolognani <abologna@redhat.com>
---

diff --git a/docs/hacking.html.in b/docs/hacking.html.in
index cad0f1e8c1..793a6b7e59 100644
--- a/docs/hacking.html.in
+++ b/docs/hacking.html.in
@@ -179,12 +179,13 @@
 
         <p>
           When debugging failures during development, it is possible
-          to focus in on just the failing subtests by using TESTS and
-          VIR_TEST_RANGE:
+          to focus in on just the failing subtests by using
+          VIR_TEST_RANGE. I.e. to run all tests from 3 to 20 with the
+          exception of tests 6 and 16, use:
         </p>
 
 <pre>
-  make check VIR_TEST_DEBUG=1 VIR_TEST_RANGE=3-5 TESTS=qemuxml2argvtest
+  VIR_TEST_DEBUG=1 VIR_TEST_RANGE=3-5,7-20,^16 ./run tests/qemuxml2argvtest
 </pre>
 
         <p>