From: Bruno Haible <bruno@clisp.org>
Date: Tue, 14 May 2024 11:25:51 +0000 (+0200)
Subject: Document how to debug failing or skipped tests.
X-Git-Tag: v2.5.1~28
X-Git-Url: http://git.ipfire.org/gitweb/gitweb.cgi?a=commitdiff_plain;h=2048edd2cba086b194bd30901e5fe552a4890680;p=thirdparty%2Flibtool.git

Document how to debug failing or skipped tests.

* HACKING (Test Suite): Explain how to debug a range of tests.
---

diff --git a/HACKING b/HACKING
index 20d65e9a8..8eea9f7d9 100644
--- a/HACKING
+++ b/HACKING
@@ -76,6 +76,12 @@ and is not part of a release distribution.
   AT_CHECK) is on a single line so that 'testsuite -x' displays the
   whole thing.  You can use m4_do or '[... ]dnl' to wrap long lines.
 
+* To debug a failing or skipped range of tests, e.g. 13 to 14:
+    make check-local TESTSUITEFLAGS="--debug 13-14"
+  More generally, in the TESTSUITEFLAGS you can use the documented
+  options for Autotest generated testsuites:
+  https://www.gnu.org/savannah-checkouts/gnu/autoconf/manual/autoconf-2.72/html_node/testsuite-Invocation.html
+
 * Run tests in parallel with
     make -k check TESTSUITEFLAGS="--jobs=$(nproc)"
   liberally, on as many platforms as you can.  Use as many compilers and