summaryrefslogtreecommitdiff
path: root/DEVELOPMENT
blob: 52d30b966999630b945c77720c1f34bb1bff580f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
Development notes
=================

The perl-kolab package is a standard perl package and a Kolab Server
core component. It is meant to be handled with the Makefile.PL
script. You will receive a standard "Makefile" by running "perl
Makefile.PL".

The Kolab Server packages were usually not released as source
packages. This should be changed with this new package layout. The
"dist" target will produce a perl-kolab-*.tar.gz package that can be
distributed as source package. The same run will produce a
perl-kolab-*.src.rpm package that is suited for installation on an
OpenPKG system.


Version numbering
=================

The package version will be set in

  lib/Kolab.pm

e.g.

  our $KOLAB_BASE_VERSION = "2.2.beta1";
  my $KOLAB_CVS = 1;

Release versions
----------------

Released packages should have the same core version as the server
release. As a part of Kolab Server 2.2.0 the version number should be
2.2.0. Pre-release candidates receive the suffix "betaX" or "rcX"
(e.g. 2.2.beta1).

Before tagging the next release the version number needs to be increased
to the new Kolab Server version (e.g. 2.2.0) and the CVS switch needs to
be set to 0:

  our $KOLAB_BASE_VERSION = "2.2.0";
  my $KOLAB_CVS = 0;

After updating $KOLAB_BASE_VERSION and $KOLAB_CVS you can commit these
changes and tag the release.

Now you can create source tarballs and RPMs which will look like:

  perl-kolab-2.2.0.tar.gz
  perl-kolab-2.2.0-20070819.src.rpm

Don't forget to change $KOLAB_CVS back to 1 again and commit, so later
CVS snapshots will be named correctly.

Snapshots
---------

Make sure lib/Kolab.pm contains the following line:

  my $KOLAB_CVS = 1;

The release number will then receive the suffix "+cvs" and the current
date will be appended.

Source tarballs and RPMs will then look like this:

  perl-kolab-2.2.0+cvs20070810.tar.gz
  perl-kolab-2.2.0+cvs-20070810.src.rpm


Change log
==========

The change log for the package is provided in "ChangeLog". Please keep
this file up-to-date if you change the source code of this package.


Contributors
============

The developers of this package are listed in "AUTHORS". Please keep
this file up-to-date if you change the source code of this package.