mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-11-06 09:26:17 +01:00
70cb59ec90
This documents what we already do, rather than trying to make any improvements to the process. They can happen separately, later, as they’re a little more involved than just writing a Markdown document. For example, we really should automate some of this. Signed-off-by: Philip Withnall <pwithnall@endlessos.org>
105 lines
4.0 KiB
Markdown
105 lines
4.0 KiB
Markdown
Making a release
|
||
===
|
||
|
||
When to make a release
|
||
---
|
||
|
||
Releases are made on a schedule determined in the [roadmap](./roadmap.md). Each
|
||
release corresponds to a [GitLab milestone](https://gitlab.gnome.org/GNOME/glib/-/milestones).
|
||
|
||
There is usually some scope to change a release date by plus or minus a week, to
|
||
allow specific merge requests to land if they are deemed as more important to
|
||
release sooner rather than waiting until the next scheduled release. However,
|
||
there is always another release, and releasing on time is more important than
|
||
releasing with everything landed. Releasing on time allows distributors to
|
||
schedule their packaging work efficiently.
|
||
|
||
Maintainers should take it in turns to make releases so that the load is spread
|
||
out evenly and every maintainer is practiced in the process.
|
||
|
||
How to make a release
|
||
---
|
||
|
||
Broadly, GLib follows the same process as [every other GNOME
|
||
module](https://wiki.gnome.org/MaintainersCorner/Releasing).
|
||
|
||
These instructions use the following variables:
|
||
- `new_version`: the version number of the release you are making, for example `2.73.1`
|
||
- `previous_version`: the version number of the most-recently released version in the same release series, for example `2.73.0`
|
||
- `branch`: the branch which the release is based on, for example `glib-2-72` or `main`
|
||
|
||
Make sure your repository is up to date and doesn’t contain local changes:
|
||
```sh
|
||
git pull
|
||
git status
|
||
```
|
||
|
||
Check the version in `meson.build` is correct for this release.
|
||
|
||
Download
|
||
[gitlab-changelog](https://gitlab.gnome.org/pwithnall/gitlab-changelog) and use
|
||
it to write a `NEWS` entry:
|
||
```sh
|
||
gitlab-changelog.py GNOME/glib ${previous_version}..
|
||
```
|
||
|
||
Copy this into `NEWS`, and manually write some highlights of the fixed bugs as
|
||
bullet points at the top. Most changes won’t need to be highlighted — only the
|
||
ones which add APIs, change dependencies or packaging requirements, or fix
|
||
impactful bugs which might affect distros’ decisions of how to prioritise the
|
||
GLib release or how urgent to mark it as.
|
||
|
||
You can get review of your `NEWS` changes from other co-maintainers if you wish.
|
||
|
||
Commit the release:
|
||
```sh
|
||
git add -p
|
||
git commit -sm "${new_version}"
|
||
```
|
||
|
||
Build the release tarball:
|
||
```sh
|
||
ninja -C build/ dist
|
||
```
|
||
|
||
Tag, sign and push the release (see below for information about `git evtag`):
|
||
```sh
|
||
git evtag sign ${new_version}
|
||
git push --atomic origin ${branch} ${new_version}
|
||
```
|
||
To use a specific key add an option `-u ${keyid|email}` after the `sign` argument.
|
||
|
||
Use `${new_version}` as the tag message.
|
||
|
||
Upload the release tarball (you will need a
|
||
[GNOME LDAP account](https://wiki.gnome.org/Infrastructure/NewAccounts) for this):
|
||
```sh
|
||
scp build/meson-dist/glib-${new_version}.tar.xz master.gnome.org:
|
||
ssh master.gnome.org ftpadmin install glib-${new_version}.tar.xz
|
||
```
|
||
|
||
Add the release notes to GitLab and close the milestone:
|
||
- Go to https://gitlab.gnome.org/GNOME/glib/-/tags/${new_version}/release/edit
|
||
and upload the release notes for the new release from the `NEWS` file
|
||
- Go to https://gitlab.gnome.org/GNOME/glib/-/releases/${new_version}/edit
|
||
and link the milestone to it, then list the new release tarball and
|
||
`sha256sum` file in the ‘Release Assets’ section as the ‘Other’ types.
|
||
Get the file links from https://download.gnome.org/sources/glib/ and
|
||
name them ‘Release tarball’ and ‘Release tarball sha256sum’
|
||
- Go to https://gitlab.gnome.org/GNOME/glib/-/milestones/
|
||
choose the milestone and close it, as all issues and merge requests tagged
|
||
for this release should now be complete
|
||
|
||
`git-evtag`
|
||
---
|
||
|
||
Releases must be done with `git evtag` rather than `git tag`, as it provides
|
||
stronger security guarantees. See
|
||
[its documentation](https://github.com/cgwalters/git-evtag) for more details.
|
||
In particular, it calculates its checksum over all blobs reachable from the tag,
|
||
including submodules; and uses a stronger checksum than SHA-1.
|
||
|
||
You will need a GPG key for this, ideally which has been signed by others so
|
||
that it can be verified as being yours. However, even if your GPG key is
|
||
unsigned, using `git evtag` is still beneficial over using `git tag`.
|