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