How to create and send a patch to QEMU

In general, git-format-patch(1) is always required
because such patches can be applied directly by git-am(1).


% git clone git://git.qemu.org/qemu.git
 # this will take a few minutes

% cd qemu

% git config user.name "My Name"

% git config user.email "myself@my.mail.host"

% vi hw/e1000.c
 # or patch/copy/type etc.

% git add hw/e1000.c
 # I'm not sure if this is required but git-commit(1) says to do git-add
 # even for modified files

% git commit hw/e1000.c
 # the first line of the commit log will be a subject of git-send-email
 # and details should be in the following paragraph
 # http://www.spheredev.org/wiki/Git_for_the_lazy#Writing_good_commit_messages

% git format-patch --signoff origin
 # this will create a patch with a looong name,
 # like 0001-first-text-line-put-as-subject-in-commit-log

% git send-email --to "qemu-devel@nongnu.org" \
   --smtp-server my.smtp.host \
   patch-filename-created-by-git-format-patch.patch
 # it would be better to test git-send-email(1) to send a message to yourself
 # before sending to the public list (may require local smtp settings)
 # it also asks:
 #  - "Who should the emails appear to be from?"
 #  - "Message-ID to be used as In-Reply-To for the first email?"
 # and shows message headers that will be sent
 # finally it asks:
 #  "Send this email? ([y]es|[n]o|[q]uit|[a]ll):"
 # then it sends a message and prints results of smtp xfers