Re: [Qemu-devel] [PATCH, RFC] Add file describing rules for submitting patches

[Philippe Waille]

Blue Swirl wrote :

> I gathered a few common complaints about patch submission,
> ...

A newbie remark : what is needed IMHO is a clear and complete documentation on 
how 
to submit a patch, at the top-level QEMU WEB page and within the tar archive. 

I tried to submit a patch (for the user mode gdbstub) and the only information 
I got
on the QEMU WEB site on how to proceed is :

"The prefered way to submit QEMU Patches is to send them to QEMU developer
mailing list".  


A look at already submitted submitted and applied patch submission messages in
the qemu-devel archive help to guess what is required, but the following 
informations 
should IHMO be clearly explained in a document "HOW to submit a patch" :

+ format (guessed svn diff)
+ inclusion (in-line or attachement, format of attachement), which files
(diff only, diff + modified files ... ?)
+ subject Line rules 
+ signature : how to sign a path submission (with a PGP key ? how to get this 
key ?)

If appropriate, add a link to a more general (GNU projects) patch submission 
policy and 
variations specific to QEMU project. 



And I can't find again the QEMU coding style document today (but the
QEMU users forum link is broken ...).

Ph. Waille