trailer --unfold help: prefer "reformat" over "join"
commit289a0b244722b69c25ec872a14518acd85f54e75
authorLinus Arver <linusa@google.com>
Thu, 7 Sep 2023 22:20:06 +0000 (7 22:20 +0000)
committerJunio C Hamano <gitster@pobox.com>
Fri, 8 Sep 2023 06:04:44 +0000 (7 23:04 -0700)
tree877d8c61207cfd7171db69109cdfb3a7bc107682
parentcb088cbe0f8589938d345b7e2524c2345fbb0166
trailer --unfold help: prefer "reformat" over "join"

The phrase "join whitespace-continued values" requires some additional
context. For example, "whitespace" means newlines (not just space
characters), and "join" means to join only the multiple lines together
for a single trailer (and not that we are joining multiple trailers
together). That is, "join" means to convert

    token: This is a very long value, with spaces and
      newlines in it.

to

    token: This is a very long value, with spaces and newlines in it.

and does not mean to convert

    token: value1
    token: value2

to

    token: value1 value2.

Update the help text to resolve the above ambiguity. While we're add it,
update the docs to use similar language as the change in the help text.

Signed-off-by: Linus Arver <linusa@google.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-interpret-trailers.txt
builtin/interpret-trailers.c