Preston_PLB/freeswitch
1
0
Fork 0
forked from Mirrors/freeswitch
Code Pull Requests Activity
2981fd57c2
freeswitch/libs/sofia-sip/docs/release_management.txt
Michael Jerris 8ff118dc2c merge with sofia darcs trunk: 
Fri Oct 12 08:42:17 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  * Makefile.am: fixed ordering of SUBDIRS

Fri Oct 12 13:32:02 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  * win32/utils/stunc.dsp: fixed include paths

Fri Oct 12 13:32:19 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  * win32/tests/torture_su_root: fixed include paths

Fri Oct 12 13:32:52 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  * win32: added missing files from Makefile.am, .dsp, vproj

Fri Oct 12 13:33:42 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  * win32/build_sources.cmd: added extra headers to sip_tag.c and sip_parser_table.c

Fri Oct 12 13:37:00 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  * win32/check.cmd: added option -a to relevant tests. 
    Optionally check Release build.

Fri Oct 12 13:37:25 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  * url.h: silenced warning on URL_INIT_AS()

Fri Oct 12 13:37:43 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  * tstdef.h: silenced warnings on TEST_M()

Fri Oct 12 13:38:15 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  * nta_internal.h, nua_params.c: fixed NTATAG_UDP_MTU() type

Fri Oct 12 13:39:06 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  * test_class.h: fixed test_auth_class, test_numeric_class declaration

Fri Oct 12 13:39:51 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  * Fixed various tests on win32.

Fri Oct 12 13:39:58 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  * sip_basic.c: removed dead code

Fri Oct 12 14:38:02 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  * nea_server.c: avoid raporting un-SUBSCRIBE twice

Fri Oct 12 14:38:31 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  * test_sip_events.c: checking some nua_i_notifier/nua_i_subscriber events

Fri Oct 12 14:38:42 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  tagged Release candidate 2 for 1.12.7

Mon Oct 15 04:03:22 EDT 2007  Pekka.Pessi@nokia.com
  * configure.ac, RELEASE: version 1.12.7

Mon Oct 15 08:27:13 EDT 2007  Pekka.Pessi@nokia.com
  * open_c: included in the dist

Tue Oct 16 08:07:46 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  * nua: Open C fixes

Wed Oct 17 06:50:11 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  * nua.docs: replace reference to nua_cli.c with sofsip_cli

Wed Oct 17 08:43:11 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  tagged rel-sofia-sip-1_12_7

Wed Oct 17 08:43:15 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  tagged 1.12.7

Wed Oct 17 11:01:12 EDT 2007  Pekka Pessi <Pekka.Pessi@nokia.com>
  * libsofia-sip-ua/su/Makefile.am: fixed problem with automake 1.9

Wed Oct 17 11:13:15 EDT 2007  Pekka.Pessi@nokia.com
  * configure.ac, RELEASE: opened tree for development

Tue Oct 23 10:45:17 EDT 2007  Pekka.Pessi@nokia.com
  * su_alloc.c: fixed su_home_init() (not initializing pointer to mutexes)

Thu Oct 25 13:15:45 EDT 2007  Pekka.Pessi@nokia.com
  * nua_notifier.c: updated nua_i_subscribe, nua_notify() and nua_r_notify documentation

Wed Nov  7 07:58:08 EST 2007  Pekka.Pessi@nokia.com
  * sofia-sip/htable2.h: fixed HTABLE_PROTOS2()



git-svn-id: http://svn.freeswitch.org/svn/freeswitch/trunk@6219 d0543943-73ff-0310-b7d9-9358b9ac24b2
2007-11-12 16:04:47 +00:00

137 lines
4.8 KiB
Plaintext
Raw Blame History

===================================
Sofia-SIP release management README
===================================
:Author: Kai Vehmanen <kai -dot vehmanen -at- nokia -dot- com>
:Version: 20060809-12
:Formatting: reStructuredText, http://docutils.sourceforge.net/rst.html
Introduction
============
This README contains instructions for making new Sofia-SIP releases.
Links to other resources
========================
sofia-sip/README.developers
The release notes
=================
The release notes should contain the following sections:
- about Sofia-SIP
- copied verbatim from sofia-sip/README
- list of changes since last release
- maintained in sofia-sip/RELEASE
- see diff between cvs/darcs between previous and
this version
- written in freshmeat.net "Changes:" style
- notes on API/ABI interface changes
- maintained in sofia-sip/RELEASE
- all changes in public interfaces, plus other
notes that developers should be aware of
- contributors to this release
- maintained in sofia-sip/RELEASE
- 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)
See the RELEASE.template file for a full list of release note
sections.
Making the release tarball
==========================
- basics: check system clock of the build host ;)
- update the version number in sofia-sip/configure.ac
- 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
- make sure everything that is supposed to be in the
release is in the master darcs tree
- run 'make distcheck' to verify everything is ready for
release (requires automake-1.7 or newer)
- tag repos (darcs and any slave trees) with release tag
'rel-sofia-sip-x_y_z', where x_y_z is the version number (see
README.developers):
sh> darcs tag -m"rel-sofia-sip-x_y_z"
sh> cvs tag rel-sofia-sip-x_y_z
- take a fresh checkout of the release using the release tag
sh> darcs get http://sofia-sip.org/repos/sofia-sip --tag=rel-sofia-sip-1_yy_z
- create the release tarball with "make distcheck" (make sure depcomp et
al libtool scripts are correctly created)
- calculate md5 and sha1 hashes using md5sum and sha1sum utilities,
and copy the values to the release-notes (see below)
Creating the release notes and updating the website
===================================================
- combine the sofia-sip/RELEASE contents with
the template found from sfnet_www/templates/relnotes.txt
- store the resulting release notes to
sfnet_www/relnotes/relnotes-sofia-sip-x.y.z.txt
- add explicit link to the release notes to
sfnet_www/download.html (three most recent releases,
see guidelines in the html comments)
- update sfnet_www/index.html to mention the latest
release
- commit the change to sf.net website CVS, and run the
sfnet_www/put_online.sh script
Uploading the release to sourceforge.net
========================================
- use the the 'Admin' -> 'File releases' tool for
creating a new release
- to upload the file, you can use for example ncftpput:
ncftpput -u anonymous -p USER@users.sourceforge.net upload.sourceforge.net /incoming/ sofia-sip-x.y.z.tar.gz
- attach the release notes (relnotes-sofia-sip-x.y.z.txt)
to the file release
Announcing releases
===================
- send an announcement mail, containing the
release notes, to sofia-sip-devel@lists.sourceforge.net
- post a news item to freshmeat.net 'sofia-sip'
project (current project owner: Kai Vehmanen)
After release
=============
- replace the RELEASE file with RELEASE.template, and
commit it to master source repository (see sofia-sip/README.developers)
- change version in configure.ac from "X.Y.Z" to
"X.Y.Zdevel" (as it is in many cases unknown what the
next version will be)
- make a "tree open for development" commit
Syncing CVS and darcs (or some other VCS)
=========================================
Some tips for synchronizing from/to different version controlled
tree.
- As CVS cannot trace file addition/move/removals, you need
to be extra careful with these. With darcs, you can use the
'darcs changes -v' command to track down all fileops since
last synchronization.
- Always tag the src-tree with "syncuser-fromvcs-to-tovcs-yearmmdd".
- Add a top-level ChangeLog entry that documents all the
changes made outside the target tree (what, who and when -
for example produced with the "darcs changes --summary"
command).
Checking API/ABI compatibility
==============================
- Use a unit test binary built against an old library,
to verify a new library version (forwards-compatibility).
- Use the 'icheck' tool (in Debian) to make comparison
between two released versions.
View Git Blame Copy Permalink