Re: storing cover letter of a patch series?

From: Philip Oakley <philipoakley@iee.org>
Date: Sep 10, 2015, 22:20 UTC
Message-ID: <A29E37E55E524B9FACB67EC05486A178@PhilipOakley>
In-Reply-To: <5f1102c0fcdb3530148ae7a6a18bd0a7@dscho.org>

From: "Johannes Schindelin" <johannes.schindelin@gmx.de>

Show 19 quoted lines

> On 2015-09-10 23:00, Jacob Keller wrote:
>> On Thu, Sep 10, 2015 at 11:58 AM, Johannes Schindelin
>> <johannes.schindelin@gmx.de> wrote:
>>>
>>> On 2015-09-10 18:28, Jacob Keller wrote:
>>>
>>>> does anyone know of any tricks for storing a cover letter for a 
>>>> patch
>>>> series inside of git somehow?
>>>
>>> It is not stored as a blob, but I use `git 
>>> branch --edit-description` to write the cover letter for patch 
>>> series when I expect a couple of iterations.
>>
>> Does this (or can it?) get used by send-email or format-patch's
>> --cover-letter? This sounds like exactly what I want.
>
> Yes, format-patch picks it up if you say `--cover-letter`.
>

I didn't know that. It doesn't appear to be mentioned in the man pages.

IIUC https://github.com/git/git/blob/master/builtin/log.c#L971 suggests that it is a deliberate extra inclusion, rather than being part of the shortlog and diffstat mentioned in the manual https://github.com/git/git/blob/master/Documentation/git-format-patch.txt#L216

Sounds like it may be a worthwhile doc patch. -- Philip