From: Ferruh Yigit Date: Fri, 3 Jul 2020 09:53:48 +0000 (+0100) Subject: doc: add patch dependency syntax to contributing guide X-Git-Url: http://git.droids-corp.org/?p=dpdk.git;a=commitdiff_plain;h=f74904ce98e84f48e8f3a96b7ad6b6347c3f44b6 doc: add patch dependency syntax to contributing guide To help managing patch dependencies, both for maintainers or automation tasks, document a syntax for commit logs or cover letters to express their dependencies. Using the syntax proposed in Bugzilla ID 210: [https://bugs.dpdk.org/show_bug.cgi?id=210] Depends-on: series-NNNNN ("Title of the series") OR Depends-on: patch-NNNNN ("Title of the patch") Signed-off-by: Ferruh Yigit --- diff --git a/doc/guides/contributing/patches.rst b/doc/guides/contributing/patches.rst index 261c4b8486..de493a901d 100644 --- a/doc/guides/contributing/patches.rst +++ b/doc/guides/contributing/patches.rst @@ -336,6 +336,24 @@ In the commit message body the Cc: stable@dpdk.org should be inserted as follows For further information on stable contribution you can go to :doc:`Stable Contribution Guide `. +Patch Dependencies +~~~~~~~~~~~~~~~~~~ + +Sometimes a patch or patchset can depend on another one. +To help the maintainers and automation tasks, please document this dependency in commit log or cover letter +with the following syntax: + +``Depends-on: series-NNNNN ("Title of the series")`` or ``Depends-on: patch-NNNNN ("Title of the patch")`` + +Where ``NNNNN`` is patchwork ID for patch or series:: + + doc: fix some parameter description + + Update the docs, fixing description of some parameter. + + Signed-off-by: Alex Smith + --- + Depends-on: series-10000 ("Title of the series") Creating Patches ----------------