Re: [PATCH 2/5] for-each-ref: fix documentation argument ordering

From: Karthik Nayak <karthik.188@gmail.com>
Date: Jul 28, 2025, 20:18 UTC
Message-ID: <CAOLa=ZRB6VJU4Km8jotcEsGMbQeb1Vq+waZriHS9c2RVxiqJhA@mail.gmail.com>
In-Reply-To: <aINitJW7Mbxswy4b@pks.im>

Patrick Steinhardt <ps@pks.im> writes:

Show 21 quoted lines

> On Thu, Jul 24, 2025 at 10:14:43AM +0200, Karthik Nayak wrote:
>> diff --git a/Documentation/git-for-each-ref.adoc b/Documentation/git-for-each-ref.adoc
>> index ae61ba642a..a170de4209 100644
>> --- a/Documentation/git-for-each-ref.adoc
>> +++ b/Documentation/git-for-each-ref.adoc
>> @@ -10,11 +10,11 @@ SYNOPSIS
>>  [verse]
>>  'git for-each-ref' [--count=<count>] [--shell|--perl|--python|--tcl]
>>  		   [(--sort=<key>)...] [--format=<format>]
>> -		   [--include-root-refs] [ --stdin | <pattern>... ]
>> -		   [--points-at=<object>]
>> +		   [--include-root-refs] [--points-at=<object>]
>>  		   [--merged[=<object>]] [--no-merged[=<object>]]
>>  		   [--contains[=<object>]] [--no-contains[=<object>]]
>> -		   [--exclude=<pattern> ...] [--start-after=<marker>]
>> +		   [(--exclude=<pattern>)...] [--start-after=<marker>]
>> +           [ --stdin | <pattern>... ]
>
> While at it we could also convert this to use `[synopsis]`.
>
> Patrick

That's a good point, Let me do that.