Lines Matching +full:update +full:- +full:docs +full:- +full:branch
5 --------
8 being the stable branch name.
11 version (Z), while the latter have a non-zero one.
17 Mesa 10.1.0 - 10.1 branch, feature
18 Mesa 10.1.4 - 10.1 branch, bugfix
19 Mesa 12.0.0 - 12.0 branch, feature
20 Mesa 12.0.2 - 12.0 branch, bugfix
25 ----------------
30 See our :doc:`calendar <release-calendar>` for information about how
35 ----------------
37 - Available approximately every three months.
38 - Feature releases are branched on or around the second Wednesday of
40 - Initial time plan available 2-4 weeks before the planned branchpoint
41 (rc1) on the mesa-announce@ mailing list.
42 - Typically, the final release will happen after 4 candidates.
47 ---------------
49 - Normally available once every two weeks.
50 - Only the latest branch has releases. See note below.
62 release manager might have to update the
63 :doc:`calendar <release-calendar>` with additional bug fix releases of
64 the current stable branch.
68 Cherry-picking and testing
69 --------------------------
71 Commits nominated for the active branch are picked as based on the
82 Cherry picking should be done with the '-x' switch (to automatically add
85 ``git cherry-pick -x abcdef12345667890``
87 Developers can request, *as an exception*, patches to be applied up-to
94 - *Ilia Mirkin*
95 - *AMD team*
103 Rossi is collaborating with Android-x86 and may provide feedback about
113 "``cherry picked from``"-tags must be preserved.
115 .. code-block:: text
140 --------------------------------
142 - *no regressions should be observed for Piglit/dEQP/CTS/Vulkan on
144 - *no regressions should be observed for Piglit using the Softpipe
149 Staging branch
150 --------------
152 A live branch, which contains the currently merge/rejected patches is
157 staging/18.1 - WIP branch for the 18.1 series
158 staging/18.2 - WIP branch for the 18.2 series
162 - People are encouraged to test the staging branch and report
164 - The branch history is not stable and it **will** be rebased,
167 --------------------
174 Before doing a branch ensure that basic build and ``meson test``
175 testing is done and there are little to-no issues. Ideally all of those
180 .. code-block:: sh
184 git commit -asm 'VERSION: bump to X.(Y+1)'
185 truncate -s0 docs/relnotes/new_features.txt
186 git commit -asm 'docs: reset new_features.txt'
190 to ``@Marge-bot``. Keep an eye on it, as you'll need to wait for it to
197 .. code-block:: sh
201 git tag -s $VERSION-branchpoint -m "Mesa $VERSION branchpoint" $LAST_COMMIT
203 # Double-check that you tagged the correct commit
204 git show $VERSION-branchpoint
209 .. code-block:: sh
211 git push origin $VERSION-branchpoint
212 git checkout $VERSION-branchpoint
217 You are now on the :ref:`staging branch <stagingbranch>`, where you
218 will be doing your release maintainer work. This branch can be rebased
220 the ``X.Y`` branch must not be altered anymore. A convenient command
223 .. code-block:: sh
225 git rebase -i mesa-$(cat VERSION)
228 `GitLab <https://gitlab.freedesktop.org/mesa/mesa/-/milestones>`__ and
233 extremely rarely - we had only one case so far (see commit
237 --------------------
244 Ensure the latest code is available - both in your local main and the
245 relevant branch.
251 :ref:`cherry-pick <pickntest>` So we do a quick 'touch test'
253 - meson dist
254 - the produced binaries work
258 .. code-block:: sh
260 __glxgears_cmd='glxgears 2>&1 | grep -v "configuration file"'
262 __es2gears_cmd='es2gears_x11 2>&1 | grep -v "configuration file"'
290 steam steam://rungameid/570 -vconsole -vulkan
301 Increment the version contained in the file ``VERSION`` at Mesa's top-level,
302 then commit this change and **push the branch** (if you forget to do
305 Use the release.sh script from X.Org `util-modular <https://gitlab.freedesktop.org/xorg/util/modula…
310 .. code-block:: sh
312 ../relative/path/to/release.sh . # append --dist if you've already done distcheck above
319 release notes, and is published in `release-maintainers-keys.asc
320 <release-maintainers-keys.asc>`__.
326 Edit ``docs/relnotes/X.Y.Z.rst`` to add the SHA256 checksums as available
327 in the ``mesa-X.Y.Z.announce`` template. Commit this change.
329 Don't forget to push the commits to both the ``staging/X.Y`` branch and
330 the ``X.Y`` branch:
332 .. code-block:: sh
343 .. code-block:: sh
345 git cherry-pick -x X.Y~1
346 git cherry-pick -x X.Y
350 .. code-block:: sh
354 , where X.Y.Z is the version you just made. This will update
355 docs/relnotes.rst and docs/release-calendar.csv. It will then generate
359 .. code-block:: sh
364 --------------------
371 Update GitLab issues
372 --------------------
374 Parse through the bug reports as listed in the docs/relnotes/X.Y.Z.rst