t: drop "verbose" helper function
commit8ddfce7144bc965b030e0359f11b7282990e72fb
authorJeff King <peff@peff.net>
Mon, 8 May 2023 19:04:57 +0000 (8 15:04 -0400)
committerJunio C Hamano <gitster@pobox.com>
Mon, 8 May 2023 21:50:28 +0000 (8 14:50 -0700)
treee703575e6fdb3ad5083e043ee0e118317ac6341d
parenta9ea5296b772b795be1be112e98ff02c95cbe639
t: drop "verbose" helper function

We have a small helper function called "verbose", with the idea that you
can write:

  verbose foo

to get a message to stderr when the "foo" command fails, even if it does
not produce any output itself. This goes back to 8ad1652418 (t5304: use
helper to report failure of "test foo = bar", 2014-10-10). It does work,
but overall it has not been a big success for two reasons:

  1. Test writers have to remember to put it there (and the resulting
     test code is longer as a result).

  2. It doesn't handle the opposite case (we expect "foo" to fail, but
     it succeeds), leading to inconsistencies in tests (which you can
     see in many hunks of this patch, e.g. ones involving "has_cr").

Most importantly, we added a136f6d8ff (test-lib.sh: support -x option
for shell-tracing, 2014-10-10) at the same time, and it does roughly the
same thing. The output is not quite as succinct as "verbose", and you
have to watch out for stray shell-traces ending up in stderr. But it
solves both of the problems above, and has clearly become the preferred
tool.

Let's consider the "verbose" function a failed experiment and remove the
last few callers (which are all many years old, and have been dwindling
as we remove them from scripts we touch for other reasons). It will be
one less thing for new test writers to see and wonder if they should be
using themselves.

Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
12 files changed:
t/t0020-crlf.sh
t/t1301-shared-repo.sh
t/t3427-rebase-subtree.sh
t/t4022-diff-rewrite.sh
t/t4062-diff-pickaxe.sh
t/t5304-prune.sh
t/t6006-rev-list-format.sh
t/t6501-freshen-objects.sh
t/t7001-mv.sh
t/t7300-clean.sh
t/t9902-completion.sh
t/test-lib-functions.sh