From: Karthik Nayak <karthik.188@gmail.com>
Date: Sat, 29 Mar 2025 18:18:52 GMT
Subject: Re: [PATCH v5 8/8] update-ref: add --batch-updates flag for stdin mode
Message-ID: <CAOLa=ZQDiCx_VJRbQB1K6EeuA2mDj4twEB98ByddUNLtB8rEKQ@mail.gmail.com>
In-Reply-To: <xmqq34evequa.fsf@gitster.g>

Junio C Hamano <gitster@pobox.com> writes:

> Jean-Noël AVILA <jn.avila@free.fr> writes:
>
>>>  SYNOPSIS
>>>  --------
>>> -[verse]
>>> -'git update-ref' [-m <reason>] [--no-deref] (-d <ref> [<old-oid>] |
>>> [--create-reflog] <ref> <new-oid> [<old-oid>] | --stdin [-z]) +[synopsis]
>>> +git update-ref [-m <reason>] [--no-deref] -d <ref> [<old-oid>]
>>> +	       [-m <reason>] [--no-deref] [--create-reflog] <ref> <new-oid>
>>> [<old-oid>] +               [-m <reason>] [--no-deref] --stdin [-z]
>>> [--batch-updates]
>>
>> In the case of expressing alternative command line invocations, you need to
>> repeat the "git update-ref" command on each line. Otherwise, it means that
>> this is the continuation of possible options of one command
>
>
> Like this?
>
> diff --git a/Documentation/git-update-ref.adoc b/Documentation/git-update-ref.adoc
> index 5be2c16776..9310ce9768 100644
> --- a/Documentation/git-update-ref.adoc
> +++ b/Documentation/git-update-ref.adoc
> @@ -9,8 +9,8 @@ SYNOPSIS
>  --------
>  [synopsis]
>  git update-ref [-m <reason>] [--no-deref] -d <ref> [<old-oid>]
> -	       [-m <reason>] [--no-deref] [--create-reflog] <ref> <new-oid> [<old-oid>]
> -               [-m <reason>] [--no-deref] --stdin [-z] [--batch-updates]
> +git update-ref [-m <reason>] [--no-deref] [--create-reflog] <ref> <new-oid> [<old-oid>]
> +git update-ref [-m <reason>] [--no-deref] --stdin [-z] [--batch-updates]
>
>  DESCRIPTION
>  -----------

I think you also caught a whitespace issue here! I'll add this locally
nevertheless, but will hold on re-rolling! Thanks both