Re: [PATCH 1/3] doc: interpret-trailers: convert to synopsis style

From: Kristoffer Haugsbakk <kristofferhaugsbakk@fastmail.com>
Date: Mar 12, 2026, 19:11 UTC
Message-ID: <faa89e88-42b0-4d52-993a-e4bf2937d711@app.fastmail.com>
In-Reply-To: <1953989.tdWV9SEqCh@piment-oiseau>

Thank you for the review.

On Thu, Mar 12, 2026, at 18:34, Jean-Noël AVILA wrote:

Show 12 quoted lines

>>[snip]
>> @@ -359,8 +359,8 @@ See-also: fe3187489d69c4 (subject of related commit)
>>  * Configure a commit template with some trailers with empty values
>>    (using sed to show and keep the trailing spaces at the end of the
>>    trailers), then configure a commit-msg hook that uses
>> -  'git interpret-trailers' to remove trailers with empty values and
>> -  to add a 'git-version' trailer:
>> +  linkgit:git-interpret-trailers[1] to remove trailers with empty values
>
> We are already in the manual page of git-interpret-trailer. It is useless to
> provide a link to the current manpage.
>

What should be written here? The existing `git interpret-trailers` or git-interpret-trailers(1)?

Show 5 quoted lines

>> and
>> +  to add a `git-version` trailer:
>>  +
>>  ------------
>>  $ cat temp.txt

I’ll incorporate all of these in the next round.