aboutsummaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorHeikki Linnakangas <heikki.linnakangas@iki.fi>2024-11-04 14:09:25 +0200
committerHeikki Linnakangas <heikki.linnakangas@iki.fi>2024-11-04 14:09:25 +0200
commit3d1aec225ac4a1199079150dabfd0d34c5054127 (patch)
tree6be62179de2473498d0b4521daf2cf1376f9fbdd /doc/src
parent5b0c46ea0932e3be64081a277b5cc01fa9571689 (diff)
downloadpostgresql-3d1aec225ac4a1199079150dabfd0d34c5054127.tar.gz
postgresql-3d1aec225ac4a1199079150dabfd0d34c5054127.zip
Make PG_TEST_EXTRA env var override the "meson setup" option
"meson test" used to ignore the PG_TEST_EXTRA environment variable, which meant that in order to run additional tests, you had to run "meson setup -DPG_TEST_EXTRA=...". That's somewhat expensive, and not consistent with autoconf builds. Allow PG_TEST_EXTRA environment variable to override the setup-time option at run time, so that you can do "PG_TEST_EXTRA=... meson test". To implement this, the configuration time value is passed as an extra "--pg-test-extra" argument to testwrap instead of adding it to the test environment. If the environment variable is set at the time of running test, testwrap uses the value from the environment variable and ignores the --pg-test-extra option. Now that "meson test" obeys the environment variable, we can remove it from the "meson setup" steps in the CI script. It will now be picked up from the environment variable like with "make check". Author: Nazir Bilal Yavuzk, Ashutosh Bapat Reviewed-by: Ashutosh Bapat with inputs from Tom Lane and Andrew Dunstan
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/installation.sgml10
1 files changed, 7 insertions, 3 deletions
diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index c5e53dace4a..5621606f59a 100644
--- a/doc/src/sgml/installation.sgml
+++ b/doc/src/sgml/installation.sgml
@@ -3080,9 +3080,13 @@ ninja install
<term><option>-DPG_TEST_EXTRA=<replaceable>TEST_SUITES</replaceable></option></term>
<listitem>
<para>
- Enable test suites which require special software to run. This option
- accepts arguments via a whitespace-separated list. See <xref
- linkend="regress-additional"/> for details.
+ Enable additional test suites, which are not run by default because
+ they are not secure to run on a multiuser system, require special
+ software to run, or are resource intensive. The argument is a
+ whitespace-separated list of tests to enable. See
+ <xref linkend="regress-additional"/> for details. If the
+ <envar>PG_TEST_EXTRA</envar> environment variable is set when the
+ tests are run, it overrides this setup-time option.
</para>
</listitem>
</varlistentry>