test suite: don't consider skipped individual tests as failing

[notmuch] / test / README

diff --git a/test/README b/test/README
index ce403cef298dd8aaeac60ab94b49a029d7839ed4..e54e36b795e852e536dab96256420edbfee84368 100644 (file)
--- a/test/README
+++ b/test/README
@@ -117,6 +117,13 @@ Note that some tests in the existing test suite rely on previous test
 items, so you cannot arbitrarily skip any test and expect the
 remaining tests to be unaffected.
 
 items, so you cannot arbitrarily skip any test and expect the
 remaining tests to be unaffected.
 

+Currently we do not consider skipped tests as build failures. For
+maximum robustness, when setting up automated build processes, you
+should explicitely skip tests, rather than relying on notmuch's
+detection of missing prerequisites. In the future we may treat tests
+unable to run because of missing prerequisites, but not explicitely
+skipped by the user, as failures.
+

 Writing Tests
 -------------
 The test script is written as a shell script.  It should start with
 Writing Tests
 -------------
 The test script is written as a shell script.  It should start with