]> Kevux Git Server - rit/commitdiff
doc: note that AT&T ksh does not work with our test suite
authorJunio C Hamano <gitster@pobox.com>
Mon, 15 Jul 2024 15:05:00 +0000 (08:05 -0700)
committerJunio C Hamano <gitster@pobox.com>
Mon, 15 Jul 2024 17:14:52 +0000 (10:14 -0700)
The scripted Porcelain commands do not allow use of "local" because
it is not universally supported, but we use it liberally in our test
scripts, which means some POSIX compliant shells (like "ksh93") can
not be used to run our tests.

Document the status quo, to help the next person who gets perplexed
seeing our tests fail.

Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/CodingGuidelines

index 1d92b2d..94ca5cf 100644 (file)
@@ -185,8 +185,8 @@ For shell scripts specifically (not exhaustive):
 
  - Even though "local" is not part of POSIX, we make heavy use of it
    in our test suite.  We do not use it in scripted Porcelains, and
-   hopefully nobody starts using "local" before they are reimplemented
-   in C ;-)
+   hopefully nobody starts using "local" before all shells that matter
+   support it (notably, ksh from AT&T Research does not support it yet).
 
  - Some versions of shell do not understand "export variable=value",
    so we write "variable=value" and then "export variable" on two