Re: [PATCH] doc: interpret-trailers: fix cmd examples
On Mon, Sep 28, 2026, at 20:29, Junio C Hamano wrote:
Show 24 quoted lines
> 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.