openscad/doc/release-checklist.txt

90 lines
2.7 KiB
Plaintext
Raw Normal View History

2011-01-22 03:28:01 +03:00
OpenSCAD Release Checklist
--------------------------
2013-05-29 09:30:01 +04:00
o Pre-release preparations
- Merge MCAD
o In MCAD clone:
$ git fetch upstream
$ git merge upstream/master
$ git push
o In OpenSCAD:
$ cd libraries/MCAD
$ git pull
$ cd ../..
$ git commit -m "Updated MCAD"
$ git push
(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)
2012-08-04 04:38:47 +04:00
2013-01-29 02:56:41 +04:00
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
2011-01-22 03:28:01 +03:00
o Update RELEASE_NOTES
2013-01-18 00:18:46 +04:00
o Update copyright year in AboutDialog.html and mainwin.cc
2011-01-22 03:28:01 +03:00
o Tag release
git tag "openscad-$VERSION"
2011-01-22 03:28:01 +03:00
o build source package
scripts/git-archive-all.py --prefix=openscad-$VERSION/ openscad-$VERSION.src.tar.gz
2011-01-22 03:28:01 +03:00
o Sanity check; build a binary or two and manually run some tests
2011-04-13 00:37:36 +04:00
2013-01-29 02:56:41 +04:00
o git push --tags
o Upload Source package
2013-01-18 00:18:46 +04:00
$ ./scripts/googlecode_upload.py -s 'Source Code' -p openscad -l Featured,Type-Source openscad-$VERSION.src.tar.gz
$ scp openscad-$VERSION.src.tar.gz openscad@files.openscad.org:www
2013-01-18 00:18:46 +04:00
o Remove VERSION environment variable
$ unset VERSION
2011-01-22 03:28:01 +03:00
2013-06-10 09:34:47 +04:00
o Write release email/blog entry
2011-04-28 17:53:58 +04:00
o Update web page
2013-06-10 09:34:47 +04:00
- news.html
- inc/src_release_links.js
2011-12-17 21:42:45 +04:00
o Update external resources:
- http://en.wikipedia.org/wiki/OpenSCAD
2013-06-10 09:34:47 +04:00
o Write to mailing list
o Tweet
2011-12-17 21:42:45 +04:00
o Notify package managers
- Ubuntu: https://launchpad.net/~chrysn
- Fedora: Miro Hrončok <miro@hroncok.cz> or <mhroncok@redhat.com>
2013-06-10 09:34:47 +04:00
- OpenSUSE: Pavol Rusnak <prusnak@opensuse.org>
- MacPorts: Frank Schima <macports2000@gmail.com>
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
2013-06-10 09:34:47 +04:00
Windows mingw cross-build:
2013-06-10 09:34:47 +04:00
FIXME: Adapt scripts/builder.sh to build release binaries