summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorÆvar Arnfjörð Bjarmason <avarab@gmail.com>2017-03-22 22:18:54 +0000
committerJunio C Hamano <gitster@pobox.com>2017-03-26 15:58:25 -0700
commit4473060bc2a96a175015d2ffd856eb68c02a1126 (patch)
treedfb86333dc690cf89ef9e94a007c0badd7c89f8d
parent57f82f4f6037fd8243f44fd8b5f553e444d13f2c (diff)
downloadgit-ab/test-readme-updates.tar.gz
t/README: clarify the test_have_prereq documentationab/test-readme-updates
Clarify the test_have_prereq documentation so that it's clear in the reader's mind when the text says "most common use of this directly" what the answer to "as opposed to what?" is. Usually this function isn't used in lieu of using the prerequisite support built into test_expect_*, mention that explicitly. This changes documentation that I added in commit 9a897893a7 ("t/README: Document the prereq functions, and 3-arg test_*", 2010-07-02). Signed-off-by: Ævar Arnfjörð Bjarmason <avarab@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
-rw-r--r--t/README8
1 files changed, 5 insertions, 3 deletions
diff --git a/t/README b/t/README
index 89512e23d4..ab386c3681 100644
--- a/t/README
+++ b/t/README
@@ -611,9 +611,11 @@ library for your script to use.
- test_have_prereq <prereq>
- Check if we have a prerequisite previously set with
- test_set_prereq. The most common use of this directly is to skip
- all the tests if we don't have some essential prerequisite:
+ Check if we have a prerequisite previously set with test_set_prereq.
+ The most common way to use this explicitly (as opposed to the
+ implicit use when an argument is passed to test_expect_*) is to skip
+ all the tests at the start of the test script if we don't have some
+ essential prerequisite:
if ! test_have_prereq PERL
then