===============================================================

README.developers - Sofia-SIP development practices

===============================================================

​

Introduction

============

​

This file is a collection of practices and rules for Sofia-SIP

development. If you have questions, or would like to make

changes, raise the issue on sofia-sip-devel (see

http://lists.sourceforge.net/lists/listinfo/sofia-sip-devel ).

​

​

Important files for developers

==============================

​

AUTHORS

    List of contributors. When contributing new code, add

    yourself to AUTHORS, and also remember to update the

    per source file copyright statements.

​

COPYRIGHTS

    List of licenses and related copyright statements. While

    majority of Sofia-SIP is licensed under LGPL, there are

    a few files with different, but LGPL compatible, licensing

    terms.

​

README.developers

    This file.

​

TODO

    Not in active use yet.

​

<dir>/ChangeLog files

    All non-trivial changes to the source code should

    be documented in the ChangeLog files. See also the

    top-level ChangeLog.

​

​

Version numbering

=================

​

Package version

---------------

​

For public releases, the package version is:

     vMAJOR.MINOR.REVISION, where MINOR is even

​

For development releases and snaphots the version is one of:

     vMAJOR.MINOR.REVISION, where minor is odd

     vMAJOR.MINOR.REVISION.YEAR.MONTH.DAY, where minor is odd

​

For all releases, the version should be changed in configure.ac

and committed to Darcs/CVS before making the release package. The person

doing the release is responsible for updating the version number.

​

Library interface versions

--------------------------

​

Sofia-SIP libraries utilize libtool interface versioning. See

​

  - http://www.gnu.org/software/libtool/manual.html#Versioning

  - http://www.gnu.org/software/libtool/manual.html#Using-Automake