git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH] vimdiff: clarify the sigil used for marking the buffer to save

From
D. Ben Knoble <ben.knoble+github@gmail.com>
Date
Mar 24, 2025, 20:45 UTC
Message-ID
<20250324204558.76145-1-ben.knoble+github@gmail.com>

The original documentation from 7b5cf8be18 (vimdiff: add tool documentation, 2022-03-30) mistakenly described the marker as an asterisk, which is the character "*". The code and examples have always looked for an arobase ("@"). ---

NB The (French) name arobase for "@" is gaining popularity in English writing but is not yet universally standard. Use of a different name when picking is fine by me.

I also did not attempt to clarify the behavior from the recent bug report [1] because I hope it is repared rather than documented.

[1]: https://lore.kernel.org/git/CAC6paJg19ue7W0VxTnGH-1ra3Zkk+pRnj6McEC755RD54xDzCA@mail.gmail.com/
 Documentation/mergetools/vimdiff.adoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/Documentation/mergetools/vimdiff.adoc b/Documentation/mergetools/vimdiff.adoc
index befa86d692..ab915df408 100644
--- a/Documentation/mergetools/vimdiff.adoc
+++ b/Documentation/mergetools/vimdiff.adoc
@@ -86,7 +86,7 @@ command.
 +
 --
 When `MERGED` is not present in the layout, you must "mark" one of the
-buffers with an asterisk. That will become the buffer you need to edit and
+buffers with an arobase (`@`). That will become the buffer you need to edit and
 save after resolving the conflicts.
 ....
 ------------------------------------------
-- 
2.48.1
Next: Eric Sunshine
Message 1 of 3 in “vimdiff: clarify the sigil used for marking the buffer to save”
  1. vimdiff: clarify the sigil used for marking the buffer to saveD. Ben Knoble, Mar 24, 2025
  2. Eric SunshineMar 24, 2025
  3. D. Ben KnobleMar 24, 2025

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.