From: Kristoffer Haugsbakk <kristofferhaugsbakk@fastmail.com>
Date: Tue, 29 Sep 2026 19:10:48 GMT
Subject: Re: [PATCH] doc: interpret-trailers: fix cmd examples
Message-ID: <be487f47-054c-443f-b5cb-b612269fedba@app.fastmail.com>
In-Reply-To: <xmqqh5j9mdpx.fsf@gitster.g>

On Mon, Sep 28, 2026, at 20:29, Junio C Hamano wrote:
> kristofferhaugsbakk@fastmail.com writes:
>
>> From: Kristoffer Haugsbakk <code@khaugsbakk.name>
>>
>> Fix `trailer.<key-alias>.cmd` examples which have remained unchanged
>> since they were written in c364b7ef (trailer: add new .cmd config
>> option, 2021-05-03). (Modulo formatting changes.)
>>
>> Use this example as a guide for how to phrase it:
>>
>>     Configure a `see` trailer with a command to show the subject of a
>>     commit that is related, and show how it works:
>
> This read as if you are declaring that you use a template that
> invented to consistently give intro for each example, and made it
> look like the use of `see` was as a placeholder.  It would have
> avoided the "Huh?" reaction if it were phrased like so:
>
>     Steal how example to show the `see` trailer is phrased and use
>     it throughout:
>
> 	Configure a `see` trailer ...
>
> Other than that, this looks good.

I’ll make that change.