Re: [Qemu-devel] patchew header docs [was: Re: [PATCH 0/6] hyperv: refactor HvSintRoute management]

[Eric Blake <eblake@redhat.com>]

On 07/03/2018 03:00 AM, Fam Zheng wrote:
> On Tue, 07/03 10:47, Roman Kagan wrote:
>> On Mon, Jul 02, 2018 at 03:55:33PM -0500, Eric Blake wrote:
>>> On 07/02/2018 11:58 AM, Roman Kagan wrote:
>>>> This series modifies the management of HvSintRoute, which is an
>>>> important building block in Hyper-V emulation infrastructure, to make it
>>>> easier to maintain and enhance, and paves the way to the more complete
>>>> Synthetic Interrupt Controller (SynIC) emulation.
>>>>
>>>> This series applies on top of "[PATCH 0/2] hyperv: ensure VP index equal
>>>> to QEMU cpu_index" series (message-id:
>>>> <20180702134156.13404-1-rkagan@virtuozzo.com>).
>>>
>>> Rewriting that in a form that patchew can parse:
>>>
>>> Based-on: 20180702134156.13404-1-rkagan@virtuozzo.com
>>
>> Thanks!
>>
>> Are patchew-recognized headers documented anywhere?
> 
> No dedicated documentation so far becasue the only recognized syntax is this
> "^Based-on: $MESSAGE_ID$" line, which is mentioned in

I seem to recall that "^Based-on: $URL$" also works, when $URL points to 
a message within https://lists.gnu.org/archive/html/qemu-devel/ (at 
least, I've used it in a few cases, rather than further looking up the 
translation from $URL to $MESSAGE_ID myself).

> 
> https://wiki.qemu.org/Contribute/SubmitAPatch
> 
> There are requests to support more, such as the git base tree information:
> 
> https://github.com/patchew-project/patchew/issues/79

And if my recollection was wrong, adding $URL support would be one of 
those requests, and perhaps ought to be given an issue so we don't 
forget it.

> 
> and once we get there, we'll find a better place to document these features so
> that people can read about it more easily.
> 
> Fam
> 

-- 
Eric Blake, Principal Software Engineer
Red Hat, Inc.           +1-919-301-3266
Virtualization:  qemu.org | libvirt.org