You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
To make release tags the `make-tag.py` script from the maintainer tools
should be used. This ensures that all the various occurences of the
version in different files match the tagged version before proceeding.
Also replace other "ping wumpus" references.
Copy file name to clipboardExpand all lines: doc/release-process.md
+9-11
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ Release Process
5
5
6
6
### Before every release candidate
7
7
8
-
* Update translations (ping wumpus on IRC) see [translation_process.md](https://github.com/bitcoin/bitcoin/blob/master/doc/translation_process.md#synchronising-translations).
8
+
* Update translations see [translation_process.md](https://github.com/bitcoin/bitcoin/blob/master/doc/translation_process.md#synchronising-translations).
9
9
* Update manpages, see [gen-manpages.sh](https://github.com/bitcoin/bitcoin/blob/master/contrib/devtools/README.md#gen-manpagessh).
10
10
* Update release candidate version in `configure.ac` (`CLIENT_VERSION_RC`).
11
11
@@ -52,6 +52,13 @@ Release Process
52
52
- Merge the release notes from the wiki into the branch.
53
53
- Ensure the "Needs release note" label is removed from all relevant pull requests and issues.
54
54
55
+
#### Tagging a release (candidate)
56
+
57
+
To tag the version (or release candidate) in git, use the `make-tag.py` script from [bitcoin-maintainer-tools](https://github.com/bitcoin-core/bitcoin-maintainer-tools). From the root of the repository run:
58
+
59
+
../bitcoin-maintainer-tools/make-tag.py v(new version, e.g. 0.20.0)
60
+
61
+
This will perform a few last-minute consistency checks in the build system files, and if they pass, create a signed tag.
55
62
56
63
## Building
57
64
@@ -73,21 +80,12 @@ Open a draft of the release notes for collaborative editing at https://github.co
73
80
74
81
For the period during which the notes are being edited on the wiki, the version on the branch should be wiped and replaced with a link to the wiki which should be used for all announcements until `-final`.
75
82
76
-
Write the release notes. `git shortlog` helps a lot, for example:
77
-
78
-
git shortlog --no-merges v(current version, e.g. 0.19.2)..v(new version, e.g. 0.20.0)
79
-
80
-
(or ping @wumpus on IRC, he has specific tooling to generate the list of merged pulls
81
-
and sort them into categories based on labels).
83
+
Generate the change log. As this is a huge amount of work to do manually, there is the `list-pulls` script to do a pre-sorting step based on github PR metadata. See the [documentation in the README.md](https://github.com/bitcoin-core/bitcoin-maintainer-tools/blob/master/README.md#list-pulls).
82
84
83
85
Generate list of authors:
84
86
85
87
git log --format='- %aN' v(current version, e.g. 0.20.0)..v(new version, e.g. 0.20.1) | sort -fiu
86
88
87
-
Tag the version (or release candidate) in git:
88
-
89
-
git tag -s v(new version, e.g. 0.20.0)
90
-
91
89
### Setup and perform Gitian builds
92
90
93
91
If you're using the automated script (found in [contrib/gitian-build.py](/contrib/gitian-build.py)), then at this point you should run it with the "--build" command. Otherwise ignore this.
0 commit comments