Debian Codegraph @

RELEASE-HOWTO

raw
1 This document provides a step-by-step list to remind Orca
2 maintainers how to make a release.
3
4 The general instructions for a release are here:
5
6 https://handbook.gnome.org/maintainers/making-a-release.html
7
8 Here's a summary for Orca:
9
10 PREPARE SOURCES FOR THE RELEASE:
11 -------------------------------
12
13 Make sure you are up to date:
14
15 git pull
16 git status
17
18 Run the `generate_gsettings_documentation.py` and `generate_dbus_documentation.py` tools.
19 Note that the latter requires that Orca is running.
20
21 Update ./NEWS with changes from the last tagged release. You can use
22 commands like the following:
23
24 Detailed commits since the 48.beta tag:
25
26 git log 48.beta..
27
28 Short list of translation changes with author names and files:
29
30 git log 48.beta.. --grep translation --pretty=format:"%s - %an" --name-only
31
32 Quick-and-dirty formatted list of translation changes:
33
34 git log 48.beta.. --grep translation --pretty=format:"%s,%an" --name-only |
35 awk -F/ '/\.po/ {gsub("\\.po", "", $NF); printf(",%s",$NF); next;}
36 {gsub("(Updated* |Add(ed)* | translation| help)", "", $0); printf("\n%s",$0);}' |
37 awk -F, '!seen[$0]++ {if (NF == 3) printf(" %-15s %-25s %s\n", $3, $1, $2);}' |
38 sort
39
40 Short list of non-translation commits:
41
42 git log 48.beta.. --grep translation --invert-grep --pretty=format:" * %s%n"
43
44 NOTE: You should also make sure the external dependencies listed in
45 meson.build and README.md are accurate.
46
47 COMMIT RELEASE CHANGES AND TAG THE RELEASE, TRIGGERING A RELEASE BUILD:
48 -----------------------------------------------------------------------
49
50 git commit -a
51 git push
52 git tag -a -s 48.rc
53 git push origin 48.rc
54
55 BUMP THE VERSION:
56 -----------------
57
58 Modify this line in ./meson.build:
59
60 version: '48.rc'
61
62 The major version (48) increments by 1 each new GNOME release cycle.
63 The minor version proceeds as follows: alpha, beta, rc, 0, 1, 2, 3, etc.
64
65 Modify ./README.md to make sure it has the right Orca version.
66
67 If this is a .0 release, modify this line in .gitlab/issue_templates/Default.md:
68
69 *Note that versions prior to version XX.x are unsupported for non-critical issues.*
70
71 setting "XX" to the major release preceding this one.
72
73 git commit -a
74 git push