1 These are Bdale's notes on how to do a release.
5 - make sure there is a doc/release-notes-<version>.xsl
6 - make sure that doc/altusmetrum.xsl has the right copyright year,
7 and add release to the revision history at the front (release notes
8 will be pulled in automatically)
10 - update the version in configure.ac
13 - make absolutely sure checked-out tree is "clean"
14 - if this is an x.y release, then:
15 git checkout -b branch-<version>
17 - if this is an x.y.z release, then:
18 git checkout branch-<version> # the x.y parts only
20 git tag -a <version> # full x.y.z version
22 - edit .git/gbp.conf to use branch-<version> as upstream if needed
25 git merge branch-<version>
27 - verify debian/changelog is "clean" ending in last release version
28 - craft a suitable debian/changelog entry, possibly using:
29 git-dch --release --new-version=<version>-1 --multimaint-merge
31 git commit -n debian/changelog -m "update changelog for Debian build"
33 - if this is a -1 release, then
34 git-buildpackage --git-no-pristine-tar
36 ../build-area/altos/altos_<version>.orig.tar.gz \
38 else if this is not a -1 release
41 git tag debian/<version>
43 - at this point we have packages in ~/debian/build-area/altos, now
44 we move on to the non-Debian part of the release process
48 ./autogen.sh --with-fat-dir=/home/bdale/web/altusmetrum/AltOS/releases
51 this pushes packages for each platform to web site
53 - copy the relevant release notes file from doc/ to
54 /home/bdale/web/altusmetrum/AltOS/releases/<rev>
56 - go edit ~/web/altusmetrum/AltOS/releases/<rev>.mdwn to include
57 release date and explicit ref to dir contents so the AltOS page
58 shows versioned links, commit and push
60 (cd doc ; make publish)
62 this pushes fresh documents to the web site
64 sudo debian/rules clean
65 git push origin master branch-1.1 debian
68 push commits and leave the build tree in an uncluttered state
70 Testing before a release
72 To verify that a build works, the following need to be checked
77 2) Connect TM *and* TD devices. Verify that you can Monitor
78 Flight from the TD and Configure Telemetrum from the TM.
80 3) Replay Flight, using your favorite .eeprom file. Check
81 each tab, especially the 'Site Map' tab. Make sure the
84 4) Graph Data. Graph a favorite .eeprom file. Make sure you
85 can zoom in on some region of the graph.