[PATCH v2 7/8] t/README: Add a section about skipping tests

From: Ævar Arnfjörð Bjarmason <avarab@gmail.com>
Date: Jul 1, 2010, 20:17 UTC
Message-ID: <1278015478-6920-8-git-send-email-avarab@gmail.com>
In-Reply-To: <1278015478-6920-1-git-send-email-avarab@gmail.com>

Signed-off-by: Ævar Arnfjörð Bjarmason <avarab@gmail.com>
---
 t/README |   12 ++++++++++++
 1 files changed, 12 insertions(+), 0 deletions(-)

diff --git a/t/README b/t/README
index 27b9658..5a291e1 100644
--- a/t/README
+++ b/t/README
@@ -231,6 +231,18 @@ This test harness library does the following things:
    consistently when command line arguments --verbose (or -v),
    --debug (or -d), and --immediate (or -i) is given.
 
+Skipping tests
+--------------
+
+If you need to skip all the remaining tests you should set skip_all
+and immediately call test_done. The string you give to skip_all will
+be used as an explanation for why the test was skipped. for instance:
+
+	if ! test_have_prereq PERL
+	then
+	    skip_all='skipping perl interface tests, perl not available'
+	    test_done
+	fi
 
 End with test_done
 ------------------

-- 
1.7.1.251.g92a7