[RFC PATCH 11/16] patman: Allow linking a series with patchwork

Simon Glass sjg at chromium.org
Mon Jul 6 13:41:58 AEST 2020

Add a new Series-link tag to tell patman how to find the series in

Signed-off-by: Simon Glass <sjg at chromium.org>

 tools/patman/README       | 8 ++++++++
 tools/patman/func_test.py | 1 +
 tools/patman/series.py    | 2 +-
 3 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/tools/patman/README b/tools/patman/README
index 52b2cf70bd..7291e47d0c 100644
--- a/tools/patman/README
+++ b/tools/patman/README
@@ -187,6 +187,14 @@ Series-name: name
 	patman does not yet use it, but it is convenient to put the branch
 	name here to help you keep track of multiple upstreaming efforts.
+Series-link: url
+	Set the URL of the series in patchwork. You can set this after you send
+	out the series and look in patchwork for the resulting series. The
+	URL you want is the one for the series itself, not any particular patch.
+	E.g. http://patchwork.ozlabs.org/project/uboot/list/?series=187331
+	When this is set, patman can compare your local branch against patchwork
+	to see what new reviews your series has collected.
 This is the patch set title
 blah blah
diff --git a/tools/patman/func_test.py b/tools/patman/func_test.py
index 810af9c604..5eb777054a 100644
--- a/tools/patman/func_test.py
+++ b/tools/patman/func_test.py
@@ -392,6 +392,7 @@ Series for my board
 This series implements support
 for my glorious board.
+Series-link: http://patchwork.ozlabs.org/project/uboot/list/?series=183237
 ''', 'serial.c', '''The code for the
 serial driver is here''')
         self.make_commit_with_file('bootm: Make it boot', '''
diff --git a/tools/patman/series.py b/tools/patman/series.py
index 9f885c8987..edb1141fa8 100644
--- a/tools/patman/series.py
+++ b/tools/patman/series.py
@@ -16,7 +16,7 @@ from patman import tools
 # Series-xxx tags that we understand
 valid_series = ['to', 'cc', 'version', 'changes', 'prefix', 'notes', 'name',
-                'cover_cc', 'process_log']
+                'cover_cc', 'process_log', 'link']
 class Series(dict):
     """Holds information about a patch series, including all tags.

More information about the Patchwork mailing list