From 3cea695dfa871494d1a13641dbc85a80474191ab Mon Sep 17 00:00:00 2001 From: Calvin Buckley Date: Tue, 20 May 2025 16:15:29 -0300 Subject: [PATCH] [ci skip] Make the upward merge for non-stable packaging more obvious The notice to merge upward is easy to miss when pushing the other branches and the RC tag. Call attention to it with code blocks, and move the note on resolving merge conflicts from an upward merge into a note. Perhaps the upward merge merits its own step and thus a renumbering? --- docs/release-process.md | 31 +++++++++++++++++++++++++++---- 1 file changed, 27 insertions(+), 4 deletions(-) diff --git a/docs/release-process.md b/docs/release-process.md index 5d603a22f078e..ac696ce656055 100644 --- a/docs/release-process.md +++ b/docs/release-process.md @@ -292,10 +292,33 @@ slightly different steps. We'll call attention where the steps differ. > > Local-only release branches should not be pushed! - Do not forget to merge up PHP-X.Y all the way to master. When resolving - the conflicts, ignore the changes from PHP-X.Y in higher branches. It - means using something like `git checkout --ours .` when on PHP.X.Y+1 or - master after the merge resulting in the conflicts. + Do not forget to merge up PHP-X.Y all the way to master, including any + intermediate version branches. + + ```shell + # No intermediate version, merge directly to master + git checkout master + git merge PHP-X.Y + ``` + + ```shell + # One intermediate version, merge upward into master + git checkout PHP-X.Y+1 + git merge PHP-X.Y + git checkout master + git merge PHP-X.Y+1 + ``` + + > 🗒 **Note** \ + > When resolving the conflicts, ignore the changes from PHP-X.Y in higher + > branches. It means using something like `git checkout --ours .` when on + > PHP.X.Y+1 or master after the merge resulting in the conflicts. + + > ```shell + > git checkout --ours . + > git add -p + > git commit + > ``` 11. Run the following using the release tag to export the tree, create the `configure` script, and build and compress three tarballs (`.tar.gz`,