From 185238fdb479e2f7007ccda47e59b65557b7ee4b Mon Sep 17 00:00:00 2001
From: Christoph Weiss <weiss@wsoptics.de>
Date: Fri, 12 Jul 2019 10:01:36 +0200
Subject: Change meson test's build failure exit code to 125

---
 man/meson.1 | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

(limited to 'man')

diff --git a/man/meson.1 b/man/meson.1
index e7c1ecb4e..5b0dc3092 100644
--- a/man/meson.1
+++ b/man/meson.1
@@ -124,6 +124,18 @@ The default way of running tests is to invoke the default build command:
 .B meson test
 provides a richer set of tools for invoking tests.
 
+.B meson test
+automatically rebuilds the necessary targets to run tests when used with the Ninja backend.
+Upon build failure,
+.B meson test
+will return an exit code of 125.
+This return code tells
+.B git bisect run
+to skip the current commit.
+Thus bisecting using git can be done conveniently like this.
+
+.B git bisect run meson test -C build_dir
+
 .SS "options:"
 .TP
 \fB\-\-repeat\fR
@@ -214,6 +226,10 @@ Usage error, or an error parsing or executing meson.build.
 .B 2
 Internal error.
 .TP
+.B 125
+.B meson test
+could not rebuild the required targets.
+.TP
 
 .SH SEE ALSO
 
-- 
cgit v1.2.3