Re: [PATCH v5 8/8] update-ref: add --batch-updates flag for stdin mode

From

Junio C Hamano <gitster@pobox.com>

Date

Mar 29, 2025, 16:36 UTC

Message-ID

<xmqq34evequa.fsf@gitster.g>

In-Reply-To

<6141866.lOV4Wx5bFT@cayenne>

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
 -----------