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

[Eric Blake]

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:
> > > > <address@hidden>).
> > >
> > > Rewriting that in a form that patchew can parse:
> > >
> > > Based-on: address@hidden
> >
> > 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