@@ -340,7 +340,11 @@ Don't:
340340 - use perl without spelling it as "$PERL_PATH". This is to help our
341341 friends on Windows where the platform Perl often adds CR before
342342 the end of line, and they bundle Git with a version of Perl that
343- does not do so, whose path is specified with $PERL_PATH.
343+ does not do so, whose path is specified with $PERL_PATH. Note that we
344+ provide a "perl" function which uses $PERL_PATH under the hood, so
345+ you do not need to worry when simply running perl in the test scripts
346+ (but you do, for example, on a shebang line or in a sub script
347+ created via "write_script").
344348
345349 - use sh without spelling it as "$SHELL_PATH", when the script can
346350 be misinterpreted by broken platform shell (e.g. Solaris).
@@ -387,7 +391,7 @@ of the test_* functions (see the "Test harness library" section
387391below), e.g.:
388392
389393 test_expect_success PERL 'I need Perl' '
390- "$PERL_PATH" -e "hlagh() if unf_unf()"
394+ perl -e "hlagh() if unf_unf()"
391395 '
392396
393397The advantage of skipping tests like this is that platforms that don't
@@ -520,7 +524,7 @@ library for your script to use.
520524
521525 test_external \
522526 'GitwebCache::*FileCache*' \
523- "$PERL_PATH" "$TEST_DIRECTORY"/t9503/test_cache_interface.pl
527+ perl "$TEST_DIRECTORY"/t9503/test_cache_interface.pl
524528
525529 If the test is outputting its own TAP you should set the
526530 test_external_has_tap variable somewhere before calling the first
@@ -536,7 +540,7 @@ library for your script to use.
536540
537541 test_external_without_stderr \
538542 'Perl API' \
539- "$PERL_PATH" "$TEST_DIRECTORY"/t9700/test.pl
543+ perl "$TEST_DIRECTORY"/t9700/test.pl
540544
541545 - test_expect_code <exit-code> <command>
542546
0 commit comments