diff options
| author | Emil Velikov <emil.velikov@collabora.com> | 2017-03-15 17:34:26 +0000 |
|---|---|---|
| committer | Emil Velikov <emil.l.velikov@gmail.com> | 2017-03-16 13:22:40 +0000 |
| commit | ccb89e72aa177ee5f95a8f5985e5aab037bd2aa7 (patch) | |
| tree | 134bde99520b71be16d5a207c002ac62a362dad6 /docs | |
| parent | 0f988add501463fcfc84d966c6e104942bd2d531 (diff) | |
docs/releasing: document how to squash/announce queued patches
In the odd case where a patch needs to be fixed, squash the appropriate
fix and document how. Add a note in the pre-release notes, such that
devs can quickly spot it.
v2: Grammar/typo fixes (Eric). Use upstream commit [SHA] as reference.
Signed-off-by: Emil Velikov <emil.velikov@collabora.com>
Reviewed-by: Eric Engestrom <eric.engestrom@imgtec.com>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/releasing.html | 38 |
1 files changed, 38 insertions, 0 deletions
diff --git a/docs/releasing.html b/docs/releasing.html index 4db30c2c7a2..b5a9a5c85bf 100644 --- a/docs/releasing.html +++ b/docs/releasing.html @@ -115,6 +115,38 @@ performed where possible. Achieved by combination of local ad-hoc scripts and AppVeyor plus Travis-CI, the latter as part of their Github integration. </p> +<p> +<strong>Note:</strong> If a patch in the current queue needs any additional +fix(es), then they should be squashed together. +<br> +The commit messages and the <code>cherry picked from</code> tags must be preserved. +</p> +<p> +This should be noted in the <a href="#prerelease">pre-announce</a> email. +<pre> + git show b10859ec41d09c57663a258f43fe57c12332698e + + commit b10859ec41d09c57663a258f43fe57c12332698e + Author: Jonas Pfeil <pfeiljonas@gmx.de> + Date: Wed Mar 1 18:11:10 2017 +0100 + + ralloc: Make sure ralloc() allocations match malloc()'s alignment. + + The header of ralloc needs to be aligned, because the compiler assumes + ... + + (cherry picked from commit cd2b55e536dc806f9358f71db438dd9c246cdb14) + + Squashed with commit: + + ralloc: don't leave out the alignment factor + + Experimentation shows that without alignment factor gcc and clang choose + ... + + (cherry picked from commit ff494fe999510ea40e3ed5827e7818550b6de126) +</pre> +</p> <h2>Regression/functionality testing</h2> @@ -290,6 +322,12 @@ Queued (NUMBER) AUTHOR (NUMBER): COMMIT SUMMARY +For example: + +Jonas Pfeil (1): + ralloc: Make sure ralloc() allocations match malloc()'s alignment. +Squashed with + ralloc: don't leave out the alignment factor Rejected (NUMBER) ================= |