source: doc/releasing-barnowl.txt @ 74312ad

release-1.7release-1.8release-1.9
Last change on this file since 74312ad was 5f08dbe, checked in by Nelson Elhage <nelhage@mit.edu>, 12 years ago
releasing-barnowl.txt: Convert to org-mode
  • Property mode set to 100644
File size: 3.0 KB
Line 
1-*- mode: org *-
2* DOING A BARNOWL RELEASE
3  - [ ] Send mail to barnowl-dev indicating that a release is
4        happening soon, and soliciting any improvements that
5        developers want included in the release.
6  - [ ] Wait a while (a week or so, or more if necessary) for any
7        pending patches to get in.
8  - [ ] Prepare the -rc commit
9   - [ ] Run ./scripts/add-changelog NEW-VERSION PREV-TAG..HEAD
10   - [ ] Edit ChangeLog to combine and filter entries
11   - [ ] Edit configure.ac to bump the version to 1.Nrc1
12  - [ ] Commit with message 'BarnOwl 1.Nrc1'; don't push until after
13        builds all succeed
14  - [ ] Run scripts/do-release with -f (so it won't complain about
15        missing changelog), makes a tarball
16  - [ ] Do a locker build (See DOING A LOCKER BUILD)
17  - [ ] Update configure.ac on master to bump the version to 1.(N+1)dev
18  - [ ] Push git git:
19   - [ ] The RC commit
20   - [ ] The configure.ac change on master
21   - [ ] A release-1.N branch pointing at the RC commit
22  - [ ] Copy tarball into /mit/barnowl/web_scripts/dist
23  - [ ] Send mail announcing the RC to barnowl-dev@mit.edu
24  - [ ] Wait 1-2 weeks, collect any bug reports
25  - [ ] Fix any reported bugs on master
26  - [ ] Cherry-pick/backport appropriate fixes from master onto
27        release-1.N
28  - [ ] If there have been many or large bugfixes, repeat the process
29        for barnowl 1.Nrc2
30
31* DOING THE ACTUAL RELEASE
32  - [ ] Update the changelog and configure.ac for barnowl 1.N
33  - [ ] run ./scripts/do-release
34  - [ ] Do the locker build
35  - [ ] Push the release tag
36  - [ ] Write up release notes
37        (I usually use the previous release's email as a template)
38  - [ ] Update the website
39   - [ ] Add the line that `do-release` printed to the changelog on the home page
40   - [ ] Add your release notes as /release-notes/1.N
41  - [ ] Send the release notes to barnowl-users@mit.edu
42
43* DOING A LOCKER BUILD
44  - [ ] Copy the tarball to build@nelhage.com
45  - [ ] ssh to build@nelhage.com and kinit
46  - [ ] On build@nelhage.com, run barnowl-build-all TARBALL.
47        This script does builds for all Debathena platforms using chroots
48        on nelhage.com, and ssh's to Athena 9 machines to do the two
49        Athena 9 builds.
50  - [ ] Sanity-check the builds
51   - [ ] Do cursory testing on debathena platforms and both athena9s.
52   - [ ] chroots on nelhage.com also useful
53  - [ ] Update symlinks with locker-update script;
54        - locker-update [-b] [-n] VERSION
55        - e.g. locker-update -b -n barnowl-1.6rc1
56   - [ ] Use -b to update the barnowl-beta name
57   - [ ] Use -n first for dry-run
58
59* LOCKER LAYOUT
60  - builds/barnowl-VERSION contains the arch-independent files by
61    version
62  - arch/SYSNAME/bin/barnowl-VERSION is the actual binary
63  - arch/SYSNAME/bin/barnowl is a symlink to ../../common/bin/barnowl
64    (wrapper script runs barnowl.real). .../barnowl.real is a symlink
65    to the latest version.
66  - zcrypt is also installed with a versioned name, but currently
67    barnowl-N will not run zcrypt-N, so we can't change that interface
68    at all.
Note: See TracBrowser for help on using the repository browser.