mirror of
https://github.com/godotengine/buildroot.git
synced 2026-01-05 14:09:53 +03:00
docs/manual: Add section about contributing to maintenance branches
Signed-off-by: Brandon Maier <brandon.maier@rockwellcollins.com>
[yann.morin.1998@free.fr:
- s/release branch/maintenance branch/
- extend the master-then-backport section
- slight eye-candy on the rest
]
Signed-off-by: Yann E. MORIN <yann.morin.1998@free.fr>
(cherry picked from commit 76ed69499d)
Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
This commit is contained in:
committed by
Peter Korsgaard
parent
42d1ad5501
commit
64cfdc599f
@@ -371,6 +371,37 @@ in the following cases:
|
|||||||
* whenever you feel it will help presenting your work, your choices,
|
* whenever you feel it will help presenting your work, your choices,
|
||||||
the review process, etc.
|
the review process, etc.
|
||||||
|
|
||||||
|
==== Patches for maintenance branches
|
||||||
|
|
||||||
|
When fixing bugs on a maintenance branch, bugs should be fixed on the
|
||||||
|
master branch first. The commit log for such a patch may then contain a
|
||||||
|
post-commit note specifying what branches are affected:
|
||||||
|
|
||||||
|
----
|
||||||
|
package/foo: fix stuff
|
||||||
|
|
||||||
|
Signed-off-by: Your Real Name <your@email.address>
|
||||||
|
---
|
||||||
|
Backport to: 2020.02.x, 2020.05.x
|
||||||
|
(2020.08.x not affected as the version was bumped)
|
||||||
|
----
|
||||||
|
|
||||||
|
Those changes will then be backported by a maintainer to the affected
|
||||||
|
branches.
|
||||||
|
|
||||||
|
However, some bugs may apply only to a specific release, for example
|
||||||
|
because it is using an older version of a package. In that case, patches
|
||||||
|
should be based off the maintenance branch, and the patch subject prefix
|
||||||
|
must include the maintenance branch name (for example "[PATCH 2020.02.x]").
|
||||||
|
This can be done with the +git format-patch+ flag +--subject-prefix+:
|
||||||
|
|
||||||
|
---------------------
|
||||||
|
$ git format-patch --subject-prefix "PATCH 2020.02.x" \
|
||||||
|
-M -s -o outgoing origin/2020.02.x
|
||||||
|
---------------------
|
||||||
|
|
||||||
|
Then send the patches with +git send-email+, as described above.
|
||||||
|
|
||||||
==== Patch revision changelog
|
==== Patch revision changelog
|
||||||
|
|
||||||
When improvements are requested, the new revision of each commit
|
When improvements are requested, the new revision of each commit
|
||||||
|
|||||||
Reference in New Issue
Block a user