9b51bbe2b6319af66060a7b6c144f466223ed744
[fw/altos] / Releasing
1 These are Bdale's notes on how to do a release.
2
3         confirm that doc/ has a release-notes file for the new release
4
5         update the version in configure.ac and commit
6
7         git tag -a <version>
8
9         - make sure checked-out tree is "clean" so git won't complain
10
11         git-buildpackage
12
13                 at this point, we have Debian packages
14
15         git tag debian/<version>
16
17         make distclean
18
19         ./autogen.sh --with-fat-dir=/home/bdale/web/altusmetrum/AltOS/releases
20         make fat
21
22                 this pushes packages for each platform to web site
23
24         - copy the relevant release notes file from doc/ to 
25             /home/bdale/web/altusmetrum/AltOS/releases/<rev>
26
27         - go edit ~/web/altusmetrum/AltOS/releases/<rev>.mdwn to include
28           release date and explicit ref to dir contents so the AltOS page
29           shows versioned links, commit and push
30
31         (cd doc ; make publish)
32
33                 this pushes fresh documents to the web site
34
35         sudo debian/rules clean
36         git push
37         git push --tags
38
39                 push commits and leave the build tree in an uncluttered state
40
41 Testing before a release
42
43         To verify that a build works, the following need to be checked
44         on each platform:
45
46         1) Install package
47
48         2) Connect TM *and* TD devices. Verify that you can Monitor
49            Flight from the TD and Configure Telemetrum from the TM.
50
51         3) Replay Flight, using your favorite .eeprom file. Check
52            each tab, especially the 'Site Map' tab. Make sure the
53            sound works.
54
55         4) Graph Data. Graph a favorite .eeprom file. Make sure you
56            can zoom in on some region of the graph.