t/README: Add a section about skipping tests
Signed-off-by: Ævar Arnfjörð Bjarmason <avarab@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Ævar Arnfjörð Bjarmason committed
Jul 2, 2010 at 14:59 UTC
b5500d16cd1021bc1430ad019512c636dd3311d6
1 file changed
+12
t/README
+12
@@ -231,6 +231,18 @@ This test harness library does the following things:
231
consistently when command line arguments --verbose (or -v),
232
--debug (or -d), and --immediate (or -i) is given.
233
234
+Skipping tests
235
+--------------
236
+
237
+If you need to skip all the remaining tests you should set skip_all
238
+and immediately call test_done. The string you give to skip_all will
239
+be used as an explanation for why the test was skipped. for instance:
240
+
241
+ if ! test_have_prereq PERL
242
+ then
243
+ skip_all='skipping perl interface tests, perl not available'
244
+ test_done
245
+ fi
246
247
End with test_done
248
------------------