Subject: Re: [GSoC][RFC PATCH 1/2] builtin/refs: add list subcommand

From: Junio C Hamano <[email-masked]>
Date: Fri, 27 Jun 2025 11:13:40 -0700

Jean-Noël Avila <[email-masked]> writes:

> Hello,
>
> I'm only focusing on the documentation part.
>
> Le 27/06/2025 à 09:49, Meet Soni a écrit :
>>
>> ---
>>  Documentation/git-refs.adoc |  95 +++++++++++++++++++++++++++++++
>>  builtin/refs.c              | 110 ++++++++++++++++++++++++++++++++++++
>>  2 files changed, 205 insertions(+)
>> 
>> diff --git a/Documentation/git-refs.adoc b/Documentation/git-refs.adoc
>> index 4d6dc994f9..d8f81eaabd 100644
>> --- a/Documentation/git-refs.adoc
>> +++ b/Documentation/git-refs.adoc
>> @@ -11,6 +11,13 @@ SYNOPSIS
>>  [synopsis]
>>  git refs migrate --ref-format=<format> [--no-reflog] [--dry-run]
>>  git refs verify [--strict] [--verbose]
>> +git refs list [--count=<count>] [--shell|--perl|--python|--tcl]
>
> please use spaces around '|' in alternative options:
> [--shell | --perl | --python | --tcl]

As this seems to be copied and pasted with minimum modification,
perhaps we are better off if you sent a "here is how you should do
it" patch against Documentation/git-for-each-ref.adoc file where
this was copied from.