# [PATCH] t/README: Add 'Skipping Tests' section below 'Running Tests' 1 messages from 2008-06-20 to 2008-06-20. Participants: Jakub Narebski. Thread: https://gitlist.dev/t/14065 ## Jakub Narebski, 2008-06-20 21:10 Subject: [PATCH] t/README: Add 'Skipping Tests' section below 'Running Tests' Message-ID: <1213996250-10406-1-git-send-email-jnareb@gmail.com> URL: https://gitlist.dev/e/1213996250-10406-1-git-send-email-jnareb%40gmail.com ``` 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 Signed-off-by: Jakub Narebski --- So I don't have to look it up every time I want to use it... t/README | 28 ++++++++++++++++++++++++++++ 1 files changed, 28 insertions(+), 0 deletions(-) diff --git a/t/README b/t/README index dc89263..8f12d48 100644 --- a/t/README +++ b/t/README @@ -59,6 +59,34 @@ Running Tests 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 ------------ -- 1.5.6 ```