[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Qemu-devel] [PATCH v3 2/2] README: Document 'git-publish' workflow
From: |
Marc-André Lureau |
Subject: |
Re: [Qemu-devel] [PATCH v3 2/2] README: Document 'git-publish' workflow |
Date: |
Mon, 5 Feb 2018 11:08:24 +0100 |
On Mon, Feb 5, 2018 at 6:47 AM, Fam Zheng <address@hidden> wrote:
> Signed-off-by: Fam Zheng <address@hidden>
Looks good, thanks,
Reviewed-by: Marc-André Lureau <address@hidden>
> ---
> README | 30 +++++++++++++++++++++++++++++-
> 1 file changed, 29 insertions(+), 1 deletion(-)
>
> diff --git a/README b/README
> index b92a07a61a..d1a944ce20 100644
> --- a/README
> +++ b/README
> @@ -56,7 +56,7 @@ 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
> @@ -68,6 +68,34 @@ the QEMU website
> https://qemu.org/Contribute/SubmitAPatch
> https://qemu.org/Contribute/TrivialPatches
>
> +A 'git-profile' 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 for once.
> +
> +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.
>
> Bug reporting
> =============
> --
> 2.14.3
>
--
Marc-André Lureau