t/README: Add 'Skipping Tests' section below 'Running Tests'
Add description of GIT_SKIP_TESTS variable, taken almost verbatim (adjusting for conventions in t/README) from the commit message in 04ece59 (GIT_SKIP_TESTS: allow users to omit tests that are known to break) Signed-off-by: Junio C Hamano <junkio@cox.net> Signed-off-by: Jakub Narebski <jnareb@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Jakub Narebski committed
Jun 20, 2008 at 23:10 UTC
fbd458a3f6bf2ba94380e2170ebfe2f53c2dec6d
1 file changed
+28
t/README
+28
@@ -59,6 +59,34 @@ You can pass --verbose (or -v), --debug (or -d), and --immediate
59
available), for more exhaustive testing.
60
61
62
+Skipping Tests
63
+--------------
64
+
65
+In some environments, certain tests have no way of succeeding
66
+due to platform limitation, such as lack of 'unzip' program, or
67
+filesystem that do not allow arbitrary sequence of non-NUL bytes
68
+as pathnames.
69
+
70
+You should be able to say something like
71
+
72
+ $ GIT_SKIP_TESTS=t9200.8 sh ./t9200-git-cvsexport-commit.sh
73
+
74
+and even:
75
+
76
+ $ GIT_SKIP_TESTS='t[0-4]??? t91?? t9200.8' make
77
+
78
+to omit such tests. The value of the environment variable is a
79
+SP separated list of patterns that tells which tests to skip,
80
+and either can match the "t[0-9]{4}" part to skip the whole
81
+test, or t[0-9]{4} followed by ".$number" to say which
82
+particular test to skip.
83
+
84
+Note that some tests in the existing test suite rely on previous
85
+test item, so you cannot arbitrarily disable one and expect the
86
+remainder of test to check what the test originally was intended
87
+to check.
88
+
89
+
90
Naming Tests
91
------------
92