v2-0001-Document-Meson-equivalents-for-running-subset-of-.patch

From 0453241b0d2cd7fcffc66f8a2730797835659be8 Mon Sep 17 00:00:00 2001
From: Nazir Bilal Yavuz <byavuz81@gmail.com>
Date: Mon, 8 Dec 2025 11:02:13 +0300
Subject: [PATCH v2] Document Meson equivalents for running subset of
 regression tests

---
 doc/src/sgml/installation.sgml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index fe8d73e1f8c..dcebb2434f2 100644
--- a/doc/src/sgml/installation.sgml
+++ b/doc/src/sgml/installation.sgml
@@ -2142,6 +2142,14 @@ ninja
     postgres instance, specify <userinput>--setup running</userinput> as an
     argument to <userinput>meson test</userinput>.
    </para>
+
+   <para>
+    A subset of the regression tests can be run with the command
+    <userinput>TESTS="boolean char" meson test --suite regress</userinput> or
+    <userinput>TESTS="boolean char" meson test --suite regress-running</userinput>.
+    Note that sometimes tests have dependencies on objects created by other
+    tests, which can cause unexpected failures.
+   </para>
   </step>
 
   <step id="meson-install">
-- 
2.51.0