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

From: Junio C Hamano <[email-masked]>
Date: Sat, 29 Mar 2025 09:36:45 -0700

Jean-Noël AVILA <[email-masked]> 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
 -----------