openscad/doc/release-checklist.txt

98 lines
2.9 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 ../..
2014-03-06 09:29:08 +04:00
$ git commit -m "Updated MCAD" libraries/MCAD
2013-05-29 09:30:01 +04:00
$ 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
2014-03-04 08:37:02 +04:00
o Update manpage: doc/openscad.1
o Update releases/$VERSION.md
o scripts/makereleasenotes.sh
2014-03-04 09:31:44 +04:00
o Update version number in doc/openscad.1
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
2014-03-09 21:13:02 +04:00
o git push --tags master
o Upload Source package
$ 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
2014-03-09 21:13:02 +04:00
o Build binaries for all platforms and wait for upload
o Announce:
o ./scripts/github-release.sh $VERSION
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
2014-03-07 09:07:52 +04:00
o Tweet as OpenSCAD
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>
2014-03-02 00:27:08 +04:00
- Arch Linux: Kyle Keen <keenerd@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