check-non-portable-shell: suggest alternative for `VAR=val shell-func`
commit7bd0cd0e7b29da382fcf2821c1bf087190ab2ffe
authorEric Sunshine <sunshine@sunshineco.com>
Sat, 27 Jul 2024 05:35:08 +0000 (27 01:35 -0400)
committerJunio C Hamano <gitster@pobox.com>
Sat, 27 Jul 2024 05:49:40 +0000 (26 22:49 -0700)
tree147590d74706cabacefe9c280cc3d8478d267cfc
parenta7fa6097473e42b3547cf59fb52fd5ff34e9bd48
check-non-portable-shell: suggest alternative for `VAR=val shell-func`

Most problems reported by check-non-portable-shell are accompanied by
advice suggesting how the test author can repair the problem. For
instance:

    error: egrep/fgrep obsolescent (use grep -E/-F)

However, when one-shot variable assignment is detected when calling a
shell function (i.e. `VAR=val shell-func`), the problem is reported, but
no advice is given. The lack of advice is particularly egregious since
neither the problem nor the workaround are likely well-known by
newcomers to the project writing tests for the first time. Address this
shortcoming by recommending the use of `test_env` which is tailor made
for this specific use-case.

Signed-off-by: Eric Sunshine <sunshine@sunshineco.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
t/check-non-portable-shell.pl