release_management.txt 4.13 KB
Newer Older
1 2 3 4 5
===================================
Sofia-SIP release management README
===================================

:Author: Kai Vehmanen <kai -dot vehmanen -at- nokia -dot- com>
6
:Version: 20110311-01
7 8 9 10 11
:Formatting: reStructuredText, http://docutils.sourceforge.net/rst.html

Introduction
============

12
This README contains instructions for making new Sofia-SIP releases.
13 14 15 16 17 18 19 20 21

Links to other resources
========================

sofia-sip/README.developers

The release notes
=================

22
The release notes should contain the following sections:
23 24 25 26 27

- about Sofia-SIP
    - copied verbatim from sofia-sip/README
- list of changes since last release
    - maintained in sofia-sip/RELEASE
28 29
    - see diff between cvs/darcs between previous and
      this version
30 31
    - written in freshmeat.net "Changes:" style
- notes on API/ABI interface changes
32
    - maintained in sofia-sip/RELEASE
33 34
    - all changes in public interfaces, plus other
      notes that developers should be aware of
35 36
- contributors to this release
    - maintained in sofia-sip/RELEASE
37 38 39
    - also sofia-sip/AUTHORS should be updated (file
      should list all persons/companies who have code/scripts/etc
      copyrighted to them in the sofia-sip tree)
40

41 42 43
See the RELEASE.template file for a full list of release note
sections.

44
Making the release tarball
45 46
==========================

47
- basics: check system clock of the build host ;)
48
- update the version number in sofia-sip/configure.ac
49 50 51 52
- make sure the library versions are correct, and you've
  frozen all library interfaces (with correct entries in
  ChangeLog files), see README.developers for more information
  on library versioning in general
53
- make sure everything that is supposed to be in the
54
  release is in the master darcs tree
55 56
- run 'make distcheck' to verify everything is ready for
  release (requires automake-1.7 or newer)
57
- tag repos (git and any slave trees) with release tag
58 59
  'rel-sofia-sip-x_y_z', where x_y_z is the version number (see
  README.developers):
60 61 62 63 64
    sh> git tag "rel-sofia-sip-x_y_z"
- take a fresh checkout of the release using the tag in separate clone:
    sh> git clone . ../release_x_y_z
    sh> cd ../release_x_y_z
    sh> git co rel-sofia-sip-x_y_z
65 66
- create the release tarball with "make distcheck" (make sure depcomp et
  al libtool scripts are correctly created)
67
- calculate md5 and sha1 hashes using md5sum and sha1sum utilities,
Pekka Pessi's avatar
Pekka Pessi committed
68 69
  and copy the values to the release-notes (see below)

70 71
Creating the release notes and updating the website
===================================================
72 73 74

- combine the sofia-sip/RELEASE contents with
  the template found from sfnet_www/templates/relnotes.txt
75
- store the resulting release notes to
76
  sfnet_www/relnotes/relnotes-sofia-sip-x.y.z.txt
77
- add explicit link to the release notes to
78
  sfnet_www/download.html (three most recent releases,
79
  see guidelines in the html comments)
80 81
- update sfnet_www/index.html to mention the latest
  release
82 83
- commit the change to sf.net website CVS, and run the
  sfnet_www/put_online.sh script
Pekka Pessi's avatar
Pekka Pessi committed
84

Pekka Pessi's avatar
Pekka Pessi committed
85 86 87 88 89
Uploading the release to sourceforge.net
========================================

- use the the 'Admin' -> 'File releases' tool for
  creating a new release
90 91
- to upload the file, you can use for example rsync:
  rsync -avP -e ssh sofia-sip-x.y.z.tar.gz USER@frs.sourceforge.net:uploads/
Pekka Pessi's avatar
Pekka Pessi committed
92 93 94
- attach the release notes (relnotes-sofia-sip-x.y.z.txt)
  to the file release

Pekka Pessi's avatar
Pekka Pessi committed
95 96 97 98
Announcing releases
===================

- send an announcement mail, containing the
99
  release notes, to sofia-sip-devel@lists.sourceforge.net
Pekka Pessi's avatar
Pekka Pessi committed
100 101
- post a news item to freshmeat.net 'sofia-sip'
  project (current project owner: Kai Vehmanen)
102 103 104 105 106

After release
=============

- replace the RELEASE file with RELEASE.template, and
107
  commit it to master source repository (see sofia-sip/README.developers)
108 109
- change version in configure.ac from "X.Y.Z" to
  "X.Y.Zdevel" (as it is in many cases unknown what the
110 111
  next version will be)
- make a "tree open for development" commit
112

113 114 115
Checking API/ABI compatibility
==============================

116
- Use a unit test binary built against an old library,
117
  to verify a new library version (forwards-compatibility).
118 119
- Use the 'icheck' tool (in Debian) to make comparison
  between two released versions.