]> git.ipfire.org Git - thirdparty/git.git/commitdiff
t: work around multibyte bug in quoted heredocs with Dash v0.5.13
authorPatrick Steinhardt <ps@pks.im>
Thu, 2 Apr 2026 06:51:18 +0000 (08:51 +0200)
committerJunio C Hamano <gitster@pobox.com>
Thu, 2 Apr 2026 18:39:42 +0000 (11:39 -0700)
When executing our test suite with Dash v0.5.13.2 one can observe
several test failures that all have the same symptoms: we have a quoted
heredoc that contains multibyte characters, but the final data does not
match what we actually wanted to write. One such example is in t0300,
where we see the diffs like the following:

  --- expect-stdout 2026-04-01 07:25:45.249919440 +0000
  +++ stdout 2026-04-01 07:25:45.254919509 +0000
  @@ -1,5 +1,5 @@
   protocol=https
   host=example.com
  -path=perú.git
  +path=perú.git
   username=foo
   password=bar

While seemingly the same, the data that we've written via the heredoc
contains some invisible bytes. The expected hex representation of the
string is:

  7065 72c3 ba2e 6769 74                 per...git

But what we actually get instead is this string:

  7065 7285 02c3 ba02 852e 6769 74       per.......git

What's important to note here is that the multibyte character exists in
both versions. But in the broken version we see that the bytes are
wrapped in a sequence of "85 02" and "02 85". This is the CTLMBCHAR byte
sequence of Dash, which it uses internally to quote multibyte sequences.

As it turns out, this bug was introduced in c5bf970 (expand: Add
multi-byte support to pmatch, 2024-06-02), which adds multibyte support
to more contexts of Dash. One of these contexts seems to be in heredocs,
and Dash _does_ correctly unquote these multibyte sequences when using
an unquoted heredoc. But the bug seems to be that this unquoting does
not happen in quoted heredocs, and the bug still exists on the latest
"master" branch.

For now, work around the bug by using unquoted heredocs instead.

Signed-off-by: Patrick Steinhardt <ps@pks.im>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
t/t0300-credentials.sh
t/t3430-rebase-merges.sh
t/t3902-quoted.sh
t/t4014-format-patch.sh
t/t4201-shortlog.sh
t/t9001-send-email.sh

index 07aa834d33e248c8703e3cf2ff85bed0e4d1439d..64ead1571ae1e1a809636ae1d55e16db21dabc9f 100755 (executable)
@@ -675,7 +675,9 @@ test_expect_success 'match percent-encoded values' '
 test_expect_success 'match percent-encoded UTF-8 values in path' '
        test_config credential.https://example.com.useHttpPath true &&
        test_config credential.https://example.com/perú.git.helper "$HELPER" &&
-       check fill <<-\EOF
+       # NOTE: do not quote this heredoc, Dash 0.5.13 has a bug with heredocs
+       # that contain multibyte chars.
+       check fill <<-EOF
        url=https://example.com/per%C3%BA.git
        --
        protocol=https
index cc627e34a741e6cfb4f5ddaf54144ea01d87038b..84b2d0e664e58f759146b499f35c3b5199da86a5 100755 (executable)
@@ -507,9 +507,11 @@ test_expect_success 'octopus merges' '
        git rebase -i --force-rebase -r HEAD^^ &&
        test "Hank" = "$(git show -s --format=%an HEAD)" &&
        test "$before" != $(git rev-parse HEAD) &&
-       test_cmp_graph HEAD^^.. <<-\EOF
+       # NOTE: do not quote this heredoc, Dash 0.5.13 has a bug with heredocs
+       # that contain multibyte chars.
+       test_cmp_graph HEAD^^.. <<-EOF
        *-.   Tüntenfüsch
-       |\ \
+       |\\ \\
        | | * three
        | * | two
        | |/
index f528008c363c68f40da3b88a34ae8ec931d0c1ac..8660ec5cb0acdb5f5722f0629936d9257482d142 100755 (executable)
@@ -60,16 +60,18 @@ With SP in it
 "\346\277\261\351\207\216\347\264\224"
 EOF
 
-cat >expect.raw <<\EOF
+# NOTE: do not quote this heredoc, Dash 0.5.13 has a bug with heredocs
+# that contain multibyte chars.
+cat >expect.raw <<EOF
 Name
-"Name and a\nLF"
-"Name and an\tHT"
-"Name\""
+"Name and a\\nLF"
+"Name and an\\tHT"
+"Name\\""
 With SP in it
-"濱野\t純"
-"濱野\n純"
+"濱野\\t純"
+"濱野\\n純"
 濱野 純
-"濱野\"純"
+"濱野\\"純"
 濱野/file
 濱野純
 EOF
index 21d6d0cd9ef679c04534fb9fa61952546c63c740..d598e953004ce7666056504b7bd958d4e5873cf6 100755 (executable)
@@ -1285,7 +1285,9 @@ test_expect_success 'format-patch wraps extremely long from-header (rfc2047)' '
        check_author "Foö Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar"
 '
 
-cat >expect <<'EOF'
+# NOTE: do not quote this heredoc, Dash 0.5.13 has a bug with heredocs
+# that contain multibyte chars.
+cat >expect <<EOF
 From: Foö Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar
  Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo Bar Foo
  Bar Foo Bar Foo Bar Foo Bar <author@example.com>
@@ -1300,7 +1302,9 @@ test_expect_success 'format-patch wraps extremely long from-header (non-ASCII wi
        test_cmp expect actual
 '
 
-cat >expect <<'EOF'
+# NOTE: do not quote this heredoc, Dash 0.5.13 has a bug with heredocs
+# that contain multibyte chars.
+cat >expect <<EOF
 Subject: [PATCH] Foö
 EOF
 test_expect_success 'subject lines are unencoded with --no-encode-email-headers' '
@@ -1312,7 +1316,9 @@ test_expect_success 'subject lines are unencoded with --no-encode-email-headers'
        test_cmp expect actual
 '
 
-cat >expect <<'EOF'
+# NOTE: do not quote this heredoc, Dash 0.5.13 has a bug with heredocs
+# that contain multibyte chars.
+cat >expect <<EOF
 Subject: [PATCH] Foö
 EOF
 test_expect_success 'subject lines are unencoded with format.encodeEmailHeaders=false' '
@@ -1523,7 +1529,9 @@ test_expect_success 'in-body headers trigger content encoding' '
        test_env GIT_AUTHOR_NAME="éxötìc" test_commit exotic &&
        test_when_finished "git reset --hard HEAD^" &&
        git format-patch -1 --stdout --from >patch &&
-       cat >expect <<-\EOF &&
+       # NOTE: do not quote this heredoc, Dash 0.5.13 has a bug with heredocs
+       # that contain multibyte chars.
+       cat >expect <<-EOF &&
        From: C O Mitter <committer@example.com>
        Content-Type: text/plain; charset=UTF-8
 
index 5f23fc147bb88d1cc3f9485cafa4da832d035ca4..9f41d56d9a556c0d10b7dfcd18d605ce37f87bf0 100755 (executable)
@@ -105,7 +105,9 @@ test_expect_success 'output from user-defined format is re-wrapped' '
 '
 
 test_expect_success !MINGW,ICONV 'shortlog wrapping' '
-       cat >expect <<\EOF &&
+       # NOTE: do not quote this heredoc, Dash 0.5.13 has a bug with heredocs
+       # that contain multibyte chars.
+       cat >expect <<EOF &&
 A U Thor (5):
       Test
       This is a very, very long first line for the commit message to see if
index e56e0c8d7770b070b706ef9b7c90b7945a0b3a3a..a8dde942f584fa5362bf22643d66401aa5316664 100755 (executable)
@@ -1649,7 +1649,9 @@ test_expect_success $PREREQ 'To headers from files reset each patch' '
 '
 
 test_expect_success $PREREQ 'setup expect' '
-cat >email-using-8bit <<\EOF
+# NOTE: do not quote this heredoc, Dash 0.5.13 has a bug with heredocs
+# that contain multibyte chars.
+cat >email-using-8bit <<EOF
 From fe6ecc66ece37198fe5db91fa2fc41d9f4fe5cc4 Mon Sep 17 00:00:00 2001
 Message-ID: <bogus-message-id@example.com>
 From: author@example.com
@@ -1735,7 +1737,9 @@ test_expect_success $PREREQ '--8bit-encoding overrides sendemail.8bitEncoding' '
 '
 
 test_expect_success $PREREQ 'setup expect' '
-       cat >email-using-8bit <<-\EOF
+       # NOTE: do not quote this heredoc, Dash 0.5.13 has a bug with heredocs
+       # that contain multibyte chars.
+       cat >email-using-8bit <<-EOF
        From fe6ecc66ece37198fe5db91fa2fc41d9f4fe5cc4 Mon Sep 17 00:00:00 2001
        Message-ID: <bogus-message-id@example.com>
        From: author@example.com
@@ -1764,7 +1768,9 @@ test_expect_success $PREREQ '--8bit-encoding also treats subject' '
 '
 
 test_expect_success $PREREQ 'setup expect' '
-       cat >email-using-8bit <<-\EOF
+       # NOTE: do not quote this heredoc, Dash 0.5.13 has a bug with heredocs
+       # that contain multibyte chars.
+       cat >email-using-8bit <<-EOF
        From fe6ecc66ece37198fe5db91fa2fc41d9f4fe5cc4 Mon Sep 17 00:00:00 2001
        Message-ID: <bogus-message-id@example.com>
        From: A U Thor <author@example.com>