mirrors/weston
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

releasing: Add example commands to release directions

Browse Source 
Note that for weston, configure.ac needs version numbers updated in
several places.  `make distcheck` for weston no longer triggers the test
suite to run, so update the directions to run a `make check`
pre-release.  Switch to using the X.org release.sh script in place of
some of the manual steps.

Signed-off-by: Bryce Harrington <bryce@osg.samsung.com>
Reviewed-by: Peter Hutterer <peter.hutterer@who-t.net>
This commit is contained in:
Bryce Harrington 2015-01-09 18:09:21 -08:00
parent 4f4b47ad20
commit b73c58e6d7
1 changed files with 31 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
releasing.txt
View File

@ -1,29 +1,42 @@
To make a release follow these steps.
To make a release of Weston and/or Wayland, follow these steps.
1. Update configure.ac to intended version, commit.
0. Update the first three lines of configure.ac to the intended
version, commit. Also note that Weston includes versioned
dependencies on 'wayland-server' and 'wayland-client' in
configure.ac which typically need updated as well.
2. make distcheck (for weston I do make distcheck TESTS= to avoid
running the tests... most of the tests pass, but the xwayland one
is flaky)
1. Verify the test suites and codebase checks pass. (All of the
tests pass should pass except for xwayland, which can be flaky.)
3. git tag -am 1.5.0 1.5.0
$ make check
4. scp tarballs to /srv/wayland.freedesktop.org/www/releases on
annarchy.freedesktop.org
2. Run the release.sh script to generate the tarballs, sign and
upload them, and generate a release announcement template.
This script can be obtained from X.org's modular package:
5. Put SHA1 for tarballs and tagged commits in release announcement
http://cgit.freedesktop.org/xorg/util/modular/tree/release.sh
6. Push configure.ac commits and tags.
The script supports a --dry-run option to test it without actually
doing a release. If the script fails on the distcheck step due to
a testsuite error that can't be fixed for some reason, you can
skip testsuite by specifying the --dist argument. Pass --help to
see other supported options.
7. Send out release announcement.
3. Compose a release announcement. The script will generate a
weston.x.y.0.announce file with a list of changes and tags.
Prepend this with a human-readable listing of the most notable
changes. For x.y.0 releases, indicate the schedule for the
x.y+1.0 release.
8. Get the release email URL from
4. Send the release announcement to wayland-devel@lists.freedesktop.org
5. Get your freshly posted release email URL from
http://lists.freedesktop.org/archives/wayland-devel/
9. Update releases.html in wayland-web with links to tarballs and
release email.
6. Update releases.html in wayland-web with links to tarballs and
the release email URL
10. Update topic in #wayland to point to release announcement
7. Update topic in #wayland to point to the release announcement URL
For x.y.0 releases, also create the x.y branch. The x.y branch is for
bug fixes and conservative changes to the x.y.0 release, and is where
@ -34,6 +47,9 @@ fixing for the x.y.1 release for a little longer) or before the x.y.0
release (like we did with the 1.5.0 release, to unblock master
development early).
$ git branch x.y
$ git push origin x.y
The master branch configure.ac version should always be (at least)
x.y.90, with x.y being the most recent stable branch. Stable branch
configure version is just whatever was most recently released from