update changelog for Debian build

[fw/altos] / Releasing

diff --git a/Releasing b/Releasing
index 4e76d791887235ddb2ca095ab7e65b7c95936ed1..1822efbe9d29cf87f30764f0e37cbbd0f6f6a194 100644 (file)
--- a/Releasing
+++ b/Releasing
@@ -1,7 +1,5 @@
 These are Bdale's notes on how to do a release.
 
 These are Bdale's notes on how to do a release.
 

-       - make sure there's a suitable ARM Cortex toolchain in /opt/cortex!
-

        git checkout master
 
        - make sure there is a doc/release-notes-<version>.xsl
        git checkout master
 
        - make sure there is a doc/release-notes-<version>.xsl


@@ -9,25 +7,33 @@ These are Bdale's notes on how to do a release.
          and add release to the revision history at the front (release notes
          will be pulled in automatically)
 
          and add release to the revision history at the front (release notes
          will be pulled in automatically)
 

+       - get a Google Maps API key and install it in
+          ~/altusmetrumllc/google-maps-api-key. If you don't have a
+          key, the app will still work, but downloading map tiles will
+          be slow, and you will only be able to download a limited
+          number per day.
+

        - update the version in configure.ac
        - update the version in configure.ac

-       - make absolutely sure checked-out tree is "clean" (commit as needed)
+        git log > ChangeLog
+       git commit -a
+
+       - make absolutely sure checked-out tree is "clean" 
+       - make absolutely sure the pdclib/ submodule is on the master branch,
+         up to date, and "clean"
+

        - if this is an x.y release, then:
                git checkout -b branch-<version>
        - if this is an x.y release, then:
                git checkout -b branch-<version>

+               git tag -a <version>
+               - edit .git/gbp.conf to use branch-<version> as upstream
+

        - if this is an x.y.z release, then:
                git checkout branch-<version>           # the x.y parts only
                git merge master
        - if this is an x.y.z release, then:
                git checkout branch-<version>           # the x.y parts only
                git merge master

-
-        git log > ChangeLog
-       git commit -a
-
-       git tag -a <version>
+               git tag -a <version>                    # full x.y.z version

 
        git checkout debian
        git merge branch-<version>
 
 
        git checkout debian
        git merge branch-<version>
 

-       - edit .git/gbp.conf to use branch-<version> as upstream and debian
-         as packaging branch, if needed
-

        - verify debian/changelog is "clean" ending in last release version
        - craft a suitable debian/changelog entry, possibly using:
        git-dch --release --new-version=<version>-1 --multimaint-merge
        - verify debian/changelog is "clean" ending in last release version
        - craft a suitable debian/changelog entry, possibly using:
        git-dch --release --new-version=<version>-1 --multimaint-merge


@@ -35,12 +41,14 @@ These are Bdale's notes on how to do a release.
         git commit -n debian/changelog -m "update changelog for Debian build"
 
        - if this is a -1 release, then
         git commit -n debian/changelog -m "update changelog for Debian build"
 
        - if this is a -1 release, then

-               git-buildpackage --git-no-pristine-tar 
+               git-buildpackage --git-no-pristine-tar --git-submodules \
+                       --git-upstream-branch=branch-<version> \ # eg 1.3
+                       --git-upstream-tag=<version>             # eg 1.3.1

                pristine-tar commit \
                pristine-tar commit \

-                       ../build-area/altos/altos_<version>.orig.tar.gz \
+                       ../build-area/altos_<version>.orig.tar.gz \

                        branch-<version>
          else if this is not a -1 release
                        branch-<version>
          else if this is not a -1 release

-               git-buildpackage
+               git-buildpackage --git-submodules

 
        git tag debian/<version>
 
 
        git tag debian/<version>
 


@@ -54,19 +62,36 @@ These are Bdale's notes on how to do a release.
 
                this pushes packages for each platform to web site
 
 
                this pushes packages for each platform to web site
 

+       # store a stable copy of ARM binaries for production use
+       cp src/easymini-v1.0/*.elf \
+          src/telegps-v1.0/*.elf \
+          src/telemega-v1.0/*.elf \
+          src/telemetrum-v2.0/*.elf \
+          ~/altusmetrumllc/Binaries/
+       cp src/easymini-v1.0/flash-loader/*.elf \
+          src/telegps-v1.0/flash-loader/*.elf \
+          src/telemega-v1.0/flash-loader/*.elf \
+          src/telemetrum-v2.0/flash-loader/*.elf \
+          ~/altusmetrumllc/Binaries/loaders/
+       (cd ~/altusmetrumllc ; git commit -a) 
+

        - copy the relevant release notes file from doc/ to 
            /home/bdale/web/altusmetrum/AltOS/releases/<rev>
 
        - copy the relevant release notes file from doc/ to 
            /home/bdale/web/altusmetrum/AltOS/releases/<rev>
 

-       - go edit ~/web/altusmetrum/AltOS/releases/<rev>.mdwn to include
-         release date and explicit ref to dir contents so the AltOS page
-         shows versioned links, commit and push
+       - create /home/bdale/web/altusmetrum/MicroPeak/releases/<rev>,
+         and move the MicroPeak installers from AltOS/releases to there
+               
+       - go edit ~/web/altusmetrum/AltOS/releases/<rev>.mdwn and 
+         /home/bdale/web/altusmetrum/MicroPeak/releases/<rev>.mdwn, to 
+         include release date and explicit ref to dir contents so the 
+         web pages shows versioned links, commit and push

 
        (cd doc ; make publish)
 
                this pushes fresh documents to the web site
 
        sudo debian/rules clean
 
        (cd doc ; make publish)
 
                this pushes fresh documents to the web site
 
        sudo debian/rules clean

-       git push origin master branch-1.1 debian
+       git push origin master branch-<version> debian pristine-tar

        git push --tags
 
                push commits and leave the build tree in an uncluttered state
        git push --tags
 
                push commits and leave the build tree in an uncluttered state