From: Linus Arver <linusa@google.com>
Date: Thu, 15 Jun 2023 03:04:45 GMT
Subject: Re: [PATCH v3 8/9] doc: trailer: mention 'key' in DESCRIPTION
Message-ID: <owlyfs6to27m.fsf@fine.c.googlers.com>
In-Reply-To: <CAP8UFD3ikE8k7TJnX7wOt9K3JAhkh4chB3Gjp1B2tofU81xXWg@mail.gmail.com>

Christian Couder <christian.couder@gmail.com> writes:

>>   This means that the trimmed <token> and <value> will be separated by
>> -`': '` (one colon followed by one space).
>> +`': '` (one colon followed by one space). If the <token> should have a  
>> different
>> +string representation than itself, then the 'key' can be configured with
>> +'trailer.<token>.key'.

> I would rather say something like:

> "A <token> can be a shortcut name, for example "sign", instead of the
> full string, for example "Signed-off-by", which should appear before
> the separator on the output. This can be configured using the
> 'trailer.<token>.key' configuration variable."

Updated in v4 with a slightly different wording versus your example.