{"thread":{"id":"14065","subject":"[PATCH] t/README: Add 'Skipping Tests' section below 'Running Tests'","startedAt":"2008-06-20T21:10:50Z","lastAt":"2008-06-20T21:10:50Z","messageCount":1,"participants":["Jakub Narebski"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"80517","messageId":"1213996250-10406-1-git-send-email-jnareb@gmail.com","threadId":"14065","inReplyTo":null,"subject":"[PATCH] t/README: Add 'Skipping Tests' section below 'Running Tests'","fromName":"Jakub Narebski","fromEmail":"jnareb@gmail.com","sentAt":"2008-06-20T21:10:50Z","receivedAt":"2008-06-20T21:10:50Z","isPatch":true,"sender":{"key":"jnareb@gmail.com","avatar":"https://avatars.githubusercontent.com/u/2706?v=4"},"body":"Add description of GIT_SKIP_TESTS variable, taken almost verbatim\n(adjusting for conventions in t/README) from the commit message in\n\n   04ece59 (GIT_SKIP_TESTS: allow users to omit tests that are known to break)\n\nSigned-off-by: Junio C Hamano <junkio@cox.net>\nSigned-off-by: Jakub Narebski <jnareb@gmail.com>\n---\nSo I don't have to look it up every time I want to use it...\n\n t/README |   28 ++++++++++++++++++++++++++++\n 1 files changed, 28 insertions(+), 0 deletions(-)\n\ndiff --git a/t/README b/t/README\nindex dc89263..8f12d48 100644\n--- a/t/README\n+++ b/t/README\n@@ -59,6 +59,34 @@ Running Tests\n \tavailable), for more exhaustive testing.\n \n \n+Skipping Tests\n+--------------\n+\n+In some environments, certain tests have no way of succeeding\n+due to platform limitation, such as lack of 'unzip' program, or\n+filesystem that do not allow arbitrary sequence of non-NUL bytes\n+as pathnames.\n+\n+You should be able to say something like\n+\n+    $ GIT_SKIP_TESTS=t9200.8 sh ./t9200-git-cvsexport-commit.sh\n+\n+and even:\n+\n+    $ GIT_SKIP_TESTS='t[0-4]??? t91?? t9200.8' make\n+\n+to omit such tests.  The value of the environment variable is a\n+SP separated list of patterns that tells which tests to skip,\n+and either can match the \"t[0-9]{4}\" part to skip the whole\n+test, or t[0-9]{4} followed by \".$number\" to say which\n+particular test to skip.\n+\n+Note that some tests in the existing test suite rely on previous\n+test item, so you cannot arbitrarily disable one and expect the\n+remainder of test to check what the test originally was intended\n+to check.\n+\n+\n Naming Tests\n ------------\n \n-- \n1.5.6\n"}]}