summaryrefslogtreecommitdiff
path: root/wiki/Releasing.wiki
blob: f6f85be669c77aa1ad49a766933e2f7f2e603ff5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
#summary Release instructions

= How to make releases =

Choose a release number; see [http://www.producingoss.com/en/development-cycle.html#release-number-simple-strategy here].

If preparing for an a.b.0 release, create a [http://www.producingoss.com/en/release-branches.html release branch] called `a.b.x` (literal `x`): `svn copy -m'Creating 1.0.x release branch' https://ipaddr-py.googlecode.com/svn/trunk/ https://ipaddr-py.googlecode.com/svn/branches/1.0.x`

If preparing for a micro release, first switch your client to the release branch: `svn switch https://ipaddr-py.googlecode.com/svn/branches/1.0.x` (or `svn co` to a new directory).  Then [http://svnbook.red-bean.com/en/1.1/ch04s03.html merge] the changes from the trunk you want, and commit them.

== Actually making a release ==

  # Update `__version__` in ipaddr.py to a string like `'1.0.0'`, and commit to the release branch.
  # Tag the version: `svn copy -m'Tagging 1.0.0 release' https://ipaddr-py.googlecode.com/svn/branches/1.0.x/trunk https://ipaddr-py.googlecode.com/svn/tags/1.0.0`
  # Write ReleaseNotes in the wiki.
  # Prepare tarball: `./setup.py sdist`.  It will appear in `./dist`.
  # Create a [http://code.google.com/p/ipaddr-py/downloads/entry new download] on Google Code.
  # Label the release `Featured` and remove that tag from the previous release.  Files with this label will appear on the project front page in a green box.
  # Make an announcement to ipaddr-py-dev@googlegroups.com and (if an a.b.0 release) to Freshmeat.  Be sure to mention notable changes.