docs: mention VIR_TEST_RANGE

Commit ab92ae333 added a cool feature, but didn't document it.

* docs/hacking.html.in: Document debugging a subset of tests.
* HACKING: Regenerate.

Signed-off-by: Eric Blake <eblake@redhat.com>

diff --git a/HACKING b/HACKING
index 256e8aeb84ead045a2152f9f15a7fc8c81046eba..f9f838109c947f3adf3bbda0f095befa51ce567d 100644 (file)
--- a/HACKING
+++ b/HACKING
@@ -123,6 +123,11 @@ VIR_TEST_DEBUG may provide larger amounts of information:
   VIR_TEST_DEBUG=1 make check    (or)
   VIR_TEST_DEBUG=2 make check
 
+When debugging failures during development, it is possible to focus in on just
+the failing subtests by using TESTS and VIR_TEST_RANGE:
+
+  make check VIR_TEST_DEBUG=1 VIR_TEST_RANGE=3-5 TESTS=qemuxml2argvtest
+
 Also, individual tests can be run from inside the "tests/" directory, like:
 
   ./qemuxml2xmltest

diff --git a/docs/hacking.html.in b/docs/hacking.html.in
index 0892b731afe03c0d08aa72c31a93dfe77210bc35..543c77e18020b0f1e4bfff5291c2c4e8eb00c8b4 100644 (file)
--- a/docs/hacking.html.in
+++ b/docs/hacking.html.in
@@ -141,6 +141,17 @@
   VIR_TEST_DEBUG=1 make check    (or)
   VIR_TEST_DEBUG=2 make check
 </pre>
+
+        <p>
+          When debugging failures during development, it is possible
+          to focus in on just the failing subtests by using TESTS and
+          VIR_TEST_RANGE:
+        </p>
+
+<pre>
+  make check VIR_TEST_DEBUG=1 VIR_TEST_RANGE=3-5 TESTS=qemuxml2argvtest
+</pre>
+
         <p>
           Also, individual tests can be run from inside the <code>tests/</code>
           directory, like: