diff options
author | Dylan Baker <[email protected]> | 2019-10-24 13:21:45 -0700 |
---|---|---|
committer | Dylan Baker <[email protected]> | 2019-10-25 15:46:19 -0700 |
commit | ca0c1e69cab67276b2f701f7c3ea43658a52fd83 (patch) | |
tree | 934587a276e7f0efa38b02261c89018813cf8ae5 /docs/releasing.html | |
parent | 8a4541aae22e0cdeb063e3fc25c84775d84f4077 (diff) |
docs: update releasing process to use new scripts and gitlab
There were several out of date entries in this document, update them to
current practices.
Reviewed-by: Juan A. Suarez <[email protected]>
Diffstat (limited to 'docs/releasing.html')
-rw-r--r-- | docs/releasing.html | 49 |
1 files changed, 12 insertions, 37 deletions
diff --git a/docs/releasing.html b/docs/releasing.html index d2dc72ff7a4..7c4e213fb92 100644 --- a/docs/releasing.html +++ b/docs/releasing.html @@ -26,8 +26,7 @@ <li><a href="#prerelease">Pre-release announcement</a> <li><a href="#release">Making a new release</a> <li><a href="#announce">Announce the release</a> -<li><a href="#website">Update the mesa3d.org website</a> -<li><a href="#bugzilla">Update Bugzilla</a> +<li><a href="#gitlab">Update Gitlab Issues</a> </ul> @@ -517,35 +516,21 @@ So we do a quick 'touch test' unset VK_ICD_FILENAMES </pre> -<h3>Update version in file VERSION</h3> - -<p> -Increment the version contained in the file VERSION at Mesa's top-level, then -commit this change. -</p> - <h3>Create release notes for the new release</h3> <p> -Create a new file docs/relnotes/X.Y.Z.html, (follow the style of the previous -release notes). Note that the sha256sums section of the release notes should -be empty (TBD) at this point. -</p> +The release notes are completely generated by the +<pre>bin/gen_release_notes.py</pre> script. Simply run this script before +bumping the version -<p> -Two scripts are available to help generate portions of the release notes: +The only thing left to do is add the sha256 sums. </p> -<pre> - ./bin/bugzilla_mesa.sh - ./bin/shortlog_mesa.sh -</pre> +<h3>Update version in file VERSION</h3> <p> -The first script identifies commits that reference bugzilla bugs and obtains -the descriptions of those bugs from bugzilla. The second script generates a -log of all commits. In both cases, HTML-formatted lists are printed to stdout -to be included in the release notes. +Increment the version contained in the file VERSION at Mesa's top-level, then +commit this change. </p> <p> @@ -591,11 +576,9 @@ Something like the following steps will do the trick: git cherry-pick -x X.Y </pre> -<p> -Also, edit docs/relnotes.html to add a link to the new release notes, -edit docs/index.html to add a news entry and a note in case of the -last release in a series, and remove the version from -docs/release-calendar.html. Then commit and push: +<p>Then run the <pre>./bin/post_verison.py X.Y.Z</pre>, where X.Y.Z is the +version you just made. This will updated docs/relnotes.html and +docs/index.html. Remove docs/release-calendar.html. Then commit and push: </p> <pre> @@ -616,15 +599,7 @@ series, if that is the case. </p> -<h2 id="website">Update the mesa3d.org website</h2> - -<p> -As the hosting was moved to freedesktop, git hooks are deployed to update the -website. Manually check that it is updated 5-10 minutes after the final <code>git push</code> -</p> - - -<h2 id="bugzilla">Update Bugzilla</h2> +<h2 id="gitlab">Update gitlab issues</h2> <p> Parse through the bugreports as listed in the docs/relnotes/X.Y.Z.html |