OpenSCAD Release Checklist
--------------------------

(See bottom of this file for how to build release binaries)

o Set VERSION and VERSIONDATE environment variable
  (VERSIONDATE is new and used to identify releases. VERSION is for humans.
   For development builds, set VERSION and VERSIONDATE to the same value)

  export VERSION=2013.01
  export VERSIONDATE=2013.01.17

  It will be used by the commands below, as well as these files: 

  scripts/release-common.sh
  scripts/publish-macosx.sh
  scripts/publish-mingw-x.sh

o Update RELEASE_NOTES
o Update copyright year in AboutDialog.html and mainwin.cc

o Tag release
  git tag "openscad-$VERSION"

o build source package
  scripts/git-archive-all.py --prefix=openscad-$VERSION/ openscad-$VERSION.src.tar.gz

o Sanity check; build a binary or two and manually run some tests

o git push --tags

o Upload Source package
  $ ./scripts/googlecode_upload.py -s 'Source Code' -p openscad -l Featured,Type-Source openscad-$VERSION.src.tar.gz

o Remove VERSION environment variable
  $ unset VERSION

o Update web page
o Write email to mailing list
o Update external resources:
  - http://en.wikipedia.org/wiki/OpenSCAD
o Notify package managers
  - Ubuntu: https://launchpad.net/~chrysn
  - Fedora: Miro Hrončok <miro@hroncok.cz> or <mhroncok@redhat.com>
  - MacPorts: 


Build and Upload Release Binaries
---------------------------------

$ export VERSIONDATE=<date of release in YYYY.MM.DD format, e.g. 2013.01.17>
$ export VERSION=<openscad version, e.g. 2013.01> # If development snapshot, you don't need version is the same as VERSIONDATE
$ tar xzf openscad-$VERSION.src.tar.gz
$ cd openscad-$VERSION

Mac OS X:

    $ ./scripts/publish-macosx.sh -> OpenSCAD-$VERSION.dmg

Linux:
    32-bit: run on a 32-bit machine or VM
    64-bit: run on a 64-bit machine or VM

    $ ./scripts/release-common.sh -> openscad-$VERSION.x86-ARCH.tar.gz
    (where ARCH will be detected and set to 32 or 64)
    $ ./scripts/googlecode_upload.py -s 'Linux Binaries' -p openscad openscad-$VERSION.x86-ARCH.tar.gz -l Featured,OpSys-Linux,Type-Archive openscad-$VERSION.x86-ARCH.tar.gz
    o Update web page with download links

Windows mingw cross-build: FIXME 32 vs. 64 bit

    $ ./scripts/publish-mingw-x.sh -> mingw32/Openscad-$VERSION.zip
                                   -> mingw32/Openscad-$VERSION-Installer.exe
    $ ./scripts/googlecode_upload.py -s 'Windows Binaries' -p openscad OpenSCAD-$VERSION.zip -l Featured,OpSys-Windows,Type-Archive OpenSCAD-$VERSION.zip
    $ ./scripts/googlecode_upload.py -s 'Windows Installer' -p openscad OpenSCAD-$VERSION-Installer.exe -l Featured,OpSys-Windows,Type-Installer OpenSCAD-$VERSION-Installer.exe
    o Update web page with download links
