From 05d8785af2a192d436df5b7734aacb4e0bab5da8 Mon Sep 17 00:00:00 2001 From: Daniel Gustafsson Date: Fri, 12 Nov 2021 21:38:10 +0100 Subject: [PATCH] Document PG_TEST_NOCLEAN in TAP test README Commit 90627cf98 added support for retaining the data directory even on successful tests, but failed to document the environment variable which controls retention. This adds a small note to the TAP test README about PG_TEST_NOCLEAN which when set skips removing the data directories from successful tests. Reviewed-by: Tom Lane Discussion: https://postgr.es/m/2B02C1B3-3F41-4E14-92B9-005D83623A0B@yesql.se --- src/test/perl/README | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/src/test/perl/README b/src/test/perl/README index d62db9b5d88..919d4a82799 100644 --- a/src/test/perl/README +++ b/src/test/perl/README @@ -23,6 +23,11 @@ tmp_check/log/ to get more info. Files named 'regress_log_XXX' are log output from the perl test scripts themselves, and should be examined first. Other files are postmaster logs, and may be helpful as additional data. +Data directories will also be left behind for analysis when a test fails; +they are named according to the test filename. But if the environment +variable PG_TEST_NOCLEAN is set, data directories will be retained +regardless of test status. + Writing tests ------------- -- 2.47.2