[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH 2/5] README: Document 'git-publish' workflow
From: |
Stefan Hajnoczi |
Subject: |
[Qemu-devel] [PATCH 2/5] README: Document 'git-publish' workflow |
Date: |
Tue, 13 Feb 2018 17:34:26 +0000 |
From: Fam Zheng <address@hidden>
[Fixed s/git-profile/git-publish/ typo and s/for once/the first time/.
--Stefan]
Signed-off-by: Fam Zheng <address@hidden>
Reviewed-by: Marc-André Lureau <address@hidden>
Message-id: address@hidden
Signed-off-by: Stefan Hajnoczi <address@hidden>
---
README | 31 ++++++++++++++++++++++++++++++-
1 file changed, 30 insertions(+), 1 deletion(-)
diff --git a/README b/README
index 2c8e1c8cc4..627633fe1d 100644
--- a/README
+++ b/README
@@ -56,12 +56,41 @@ The QEMU source code is maintained under the GIT version
control system.
git clone git://git.qemu.org/qemu.git
-When submitting patches, the preferred approach is to use 'git
+When submitting patches, one common approach is to use 'git
format-patch' and/or 'git send-email' to format & send the mail to the
address@hidden mailing list. All patches submitted must contain
a 'Signed-off-by' line from the author. Patches should follow the
guidelines set out in the HACKING and CODING_STYLE files.
+A 'git-publish' utility was created to make above process less
+cumbersome, and is highly recommended for making regular contributions,
+or even just for sending consecutive patch series revisions. It also
+requires a working 'git send-email' setup, and by default doesn't
+automate everything, so you may want to go through the above steps
+manually the first time.
+
+For installation instructions, please go to
+
+ https://github.com/stefanha/git-publish
+
+The workflow with 'git-publish' is:
+
+ $ git checkout master -b my-feature
+ $ # work on new commits, add your 'Signed-off-by' lines to each
+ $ git publish
+
+Your patch series will be sent and tagged as my-feature-v1 if you need to refer
+back to it in the future.
+
+Sending v2:
+
+ $ git checkout my-feature # same topic branch
+ $ # making changes to the commits (using 'git rebase', for example)
+ $ git publish
+
+Your patch series will be sent with 'v2' tag in the subject and the git tip
+will be tagged as my-feature-v2.
+
Additional information on submitting patches can be found online via
the QEMU website
--
2.14.3
Re: [Qemu-devel] [PATCH 1/5] Add a git-publish configuration file, Philippe Mathieu-Daudé, 2018/02/14
[Qemu-devel] [PATCH 2/5] README: Document 'git-publish' workflow,
Stefan Hajnoczi <=
[Qemu-devel] [PATCH 5/5] misc: fix spelling, Stefan Hajnoczi, 2018/02/13
[Qemu-devel] [PATCH 4/5] ratelimit: don't align wait time with slices, Stefan Hajnoczi, 2018/02/13
Re: [Qemu-devel] [PATCH 0/5] Block patches, Fam Zheng, 2018/02/13