]> git.ipfire.org Git - thirdparty/git.git/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 1d92b2da03e8ca4f6f562ed55e2a6d9199b592c3..94ca5cf7c064ed262a4b741378714cdd212b129d 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