Making A Release

+ +

+ + +

frysk is making point release, cut from the Git +repository's HEAD, on the first Wednesday of each month. +This lets us deliver new features quickly, with a relatively low +overhead.

+ +

The relese branch is taken on the first Wednesday at 00:00 +GMT, just in time for frysk's Wednesday meeting. We +then, during the meeting, conduct a brief review, check the NEWS file, +and make a go/no-go decision. It is then pushed out, perhaps with a +few minor fixes.

+ +

The process is also relatively simplistic. It assumes for +instance: + +

there's never a pre-release tar-ball
that would require extra +pre-release version numbers such as 0.1.90... and then only +at the last moment set the real version (0.2). +
if there's ever a need for a re-spin, it just gets assigned a +patch-level number like 0.2.1 and use the original releases +branch

+ +

Cutting the Branch

+ +

Here's a suggested sequence:

+ +

To make things easier, first lets set up a few standard shell +variables; you'll want to set version to something more +meaningful: + +

+version=0.2 ! ! ! change this
+echo $version
+date=`date -u +"%Y.%m.%d"`
+echo date=$date 1>&2
+shar1=`git-rev-list --before=$date -n1 HEAD`
+echo shar1=$shar1 1>&2
+branch=frysk/$version
+echo $branch
+

Next we create a branch (frysk release branches are named +frysk/<version>), and push that upstream: + +
```
+echo branch=$branch shar1=$shar1
+git branch $branch $shar1
+git push origin $branch
+
```
+

Finally, we update the version number of the branch, and push +that: +

+git checkout $branch
+echo $version > common/version.in
+cat common/version.in
+git add common/version.in
+git commit -m "Set version.in to $version"
+git push origin
+

+ +

The branch can then be checked out by everyone and build locally. +Of course the keen will have already checked out the branch point +using something like: + +

+git checkout `git-rev-list --before='00:00 GMT' -n1 HEAD`
+

+ +

Making the Release

+ +

Here's a sequence for releasing frysk, we're assuming that $version +was set above: + +

First lets create a tar ball from the head of the branch. It's a +little convoluted since it find's the branch head's shar1 and then +uses that. + +

+echo version=$version branch=$branch
+shar1=`git-rev-list -n1 $branch`
+echo shar1=$shar1
+rm -rf frysk-$version
+git archive --prefix=frysk-$version/ $shar1 | tar xpf -
+tar cfj frysk-$version.tar.bz2 frysk-$version
+

Assuming you're happy with that, tag the release: +

+git tag -u <gpg-name> -m frysk-$version $shar1
+git push --tags
+

+ + +