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

3 messages from 2025-03-24 to 2025-03-24. Participants: D. Ben Knoble, Eric Sunshine.
Thread: https://gitlist.dev/t/63186

## D. Ben Knoble, 2025-03-24 20:45

Subject: [PATCH] vimdiff: clarify the sigil used for marking the buffer to save
Message-ID: <20250324204558.76145-1-ben.knoble+github@gmail.com>
URL: https://gitlist.dev/e/20250324204558.76145-1-ben.knoble%2Bgithub%40gmail.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


```

## Eric Sunshine, 2025-03-24 20:47

Subject: Re: [PATCH] vimdiff: clarify the sigil used for marking the buffer to save
Message-ID: <CAPig+cQg_VTN7Ug3FTdLdkVwSPZGiQHJZSpCkA2pTxwBiT29bw@mail.gmail.com>
URL: https://gitlist.dev/e/CAPig%2BcQg_VTN7Ug3FTdLdkVwSPZGiQHJZSpCkA2pTxwBiT29bw%40mail.gmail.com
In-Reply-To: <20250324204558.76145-1-ben.knoble+github@gmail.com>

```
On Mon, Mar 24, 2025 at 4:46 PM D. Ben Knoble
<ben.knoble+github@gmail.com> wrote:
> 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 ("@").
> ---

Missing sign-off.

```

## D. Ben Knoble, 2025-03-24 20:51

Subject: Re: [PATCH] vimdiff: clarify the sigil used for marking the buffer to save
Message-ID: <CALnO6CAcue+fnm8-CYobdraoieXA1Mzh8yb8V4e7N6w73+_ZEA@mail.gmail.com>
URL: https://gitlist.dev/e/CALnO6CAcue%2Bfnm8-CYobdraoieXA1Mzh8yb8V4e7N6w73%2B_ZEA%40mail.gmail.com
In-Reply-To: <CAPig+cQg_VTN7Ug3FTdLdkVwSPZGiQHJZSpCkA2pTxwBiT29bw@mail.gmail.com>

```
On Mon, Mar 24, 2025 at 4:47 PM Eric Sunshine <sunshine@sunshineco.com> wrote:
>
> On Mon, Mar 24, 2025 at 4:46 PM D. Ben Knoble
> <ben.knoble+github@gmail.com> wrote:
> > 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 ("@").
> > ---
>
> Missing sign-off.

doh, indeed.

```
