[Qemu-devel] [PSA] changelog and pull requests

[Paolo Bonzini]

Hi all!

If you are receiving this email, you have sent a pull request for QEMU
2.12!  That's awesome, and some of you have also updated the ChangeLog
for the upcoming release, which is doubly awesome!  I'm sure Santa will
put you on the nice list and you can stop reading this email. :)

Even if you haven't updated the ChangeLog, don't worry, I have done it
for you.  Please double check because QEMU is too big for one person to
understand all the changes that were made.

Some of you have spent time throughout the release to write nice
messages for the pull requests.  That's very good too, and hopefully
that has helped me and the ChangeLog entries for your subsystems are
already acceptable.

Whoever remains, you have tagged your updates with messages like "xxx
pull request".  Please don't do this, and please do double check the
2.12 page on the wiki because chances are that I have missed or
misunderstood something (no maintainer with poor tag messages has
updated the ChangeLog[1]).

Please, please think of the poor person who has spent about one hour
collecting all your changes, and use 2 minutes after typing "git tag",
while compiling the code one last time, to put together a short
description of what is happening (especially features and user-visible
hanges) in your pull request.

To put it clearly: all that should be needed in order to write the 2.13
ChangeLog should be "git log --merges --reverse v2.12.0..", and that's
exactly what I'll do three months from now: if you don't write good
messages for your tags, you'll have to write the ChangeLog for your
subsystems yourself.

Thanks,

Paolo

[1] If you did update the ChangeLog, you were supposed to stop reading,
weren't you?