[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH v3 2/6] docs/devel: add git-publish for patch submitting
From: |
Pierrick Bouvier |
Subject: |
[PATCH v3 2/6] docs/devel: add git-publish for patch submitting |
Date: |
Fri, 6 Dec 2024 11:28:56 -0800 |
Signed-off-by: Pierrick Bouvier <pierrick.bouvier@linaro.org>
---
docs/devel/submitting-a-patch.rst | 25 +++++++++++++++++++++++++
1 file changed, 25 insertions(+)
diff --git a/docs/devel/submitting-a-patch.rst
b/docs/devel/submitting-a-patch.rst
index 03b2ac298aa..69df7682c5e 100644
--- a/docs/devel/submitting-a-patch.rst
+++ b/docs/devel/submitting-a-patch.rst
@@ -235,6 +235,31 @@ to another list.) ``git send-email`` (`step-by-step setup
guide
works best for delivering the patch without mangling it, but
attachments can be used as a last resort on a first-time submission.
+.. _use_git_publish:
+
+Use git-publish
+~~~~~~~~~~~~~~~
+
+If you already configured git send-email, you can simply use `git-publish
+<https://github.com/stefanha/git-publish>`__ to send series.
+
+::
+
+ $ git checkout master -b my-feature
+ $ # work on new commits, add your 'Signed-off-by' lines to each
+ $ git publish
+ $ ... more work, rebase on master, ...
+ $ git publish # will send a v2
+
+Each time you post a series, git-publish will create a local tag with the
format
+``<branchname>-v<version>`` to record the patch series.
+
+When sending patch emails, 'git publish' will consult the output of
+'scripts/get_maintainers.pl' and automatically CC anyone listed as maintainers
+of the affected code. Generally you should accept the suggested CC list, but
+there may sometimes be scenarios where it is appropriate to cut it down (eg on
+certain large tree-wide cleanups), or augment it with other interested people.
+
.. _if_you_cannot_send_patch_emails:
If you cannot send patch emails
--
2.39.5
- [PATCH v3 0/6] Enhance documentation for new developers, Pierrick Bouvier, 2024/12/06
- [PATCH v3 1/6] docs/devel: remove dead video link for sourcehut submit process, Pierrick Bouvier, 2024/12/06
- [PATCH v3 3/6] docs/devel: add b4 for patch retrieval, Pierrick Bouvier, 2024/12/06
- [PATCH v3 4/6] docs/devel: add information on how to setup build environments, Pierrick Bouvier, 2024/12/06
- [PATCH v3 6/6] docs: add a glossary, Pierrick Bouvier, 2024/12/06
- [PATCH v3 2/6] docs/devel: add git-publish for patch submitting,
Pierrick Bouvier <=
- [PATCH v3 5/6] docs: add a codebase section, Pierrick Bouvier, 2024/12/06