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