diff options
| author | Jakub Narebski <jnareb@gmail.com> | 2008-06-20 23:10:50 +0200 |
|---|---|---|
| committer | Junio C Hamano <gitster@pobox.com> | 2008-06-21 00:02:31 -0700 |
| commit | fbd458a3f6bf2ba94380e2170ebfe2f53c2dec6d (patch) | |
| tree | 28784b325813c73a8edf7c631887f3b1f9e8e682 | |
| parent | cdeaf10f7e2754054c7be5d74227c698d2a71890 (diff) | |
| download | git-fbd458a3f6bf2ba94380e2170ebfe2f53c2dec6d.tar.gz git-fbd458a3f6bf2ba94380e2170ebfe2f53c2dec6d.tar.xz | |
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>
| -rw-r--r-- | t/README | 28 |
1 files changed, 28 insertions, 0 deletions
@@ -59,6 +59,34 @@ You can pass --verbose (or -v), --debug (or -d), and --immediate available), for more exhaustive testing. +Skipping Tests +-------------- + +In some environments, certain tests have no way of succeeding +due to platform limitation, such as lack of 'unzip' program, or +filesystem that do not allow arbitrary sequence of non-NUL bytes +as pathnames. + +You should be able to say something like + + $ GIT_SKIP_TESTS=t9200.8 sh ./t9200-git-cvsexport-commit.sh + +and even: + + $ GIT_SKIP_TESTS='t[0-4]??? t91?? t9200.8' make + +to omit such tests. The value of the environment variable is a +SP separated list of patterns that tells which tests to skip, +and either can match the "t[0-9]{4}" part to skip the whole +test, or t[0-9]{4} followed by ".$number" to say which +particular test to skip. + +Note that some tests in the existing test suite rely on previous +test item, so you cannot arbitrarily disable one and expect the +remainder of test to check what the test originally was intended +to check. + + Naming Tests ------------ |