[Evolution] Using the svn tree

[Margarita Manterola]

These are the instructions on how to use the svn pkg-evolution
repository and how it's organized.

Repository
========

The repository is located at:
svn+ssh://user@svn.debian.org/svn/pkg-evolution

You can check it out by doing:
svn co svn+ssh://user@svn.debian.org/svn/pkg-evolution 

And you can browse it in the web at:
http://svn.debian.org/wsvn/pkg-evolution

Organization
==========

Now, about the organization of the subversion tree, it's divided into
3 parts: trunk, tags and branches.  Each of them contains the name of
the different packages (currently evolution and
evolution-data-server).

You should always modify the files in trunk.  Unless it's needed to
have extra files in the tree, having only the "debian/" dir is usually
enough, since all patches are applied through debian/patches.

Once an updated package is uploaded (and thus "released") it needs to
be copied to the tags directory.  This is quite simple.  You can do it
by standing at the root dir of the svn copy (pkg-evolution, for
example) and doing:

svn cp trunk/evolution/ tags/evolution/2.4.0-1/

This tags the current copy of evolution as the 2.4.0-1 version.

How to work
==========

What I do is that I modify what ever I need to modify in the "debian/"
dir, and then copy the dir inside the sources that I want to compile
and test out.  If I need to modify anything, I always do it first in
the svn working copy, then copy the file/s to the source dir.

This is a bit cumbersome, but I haven't found a better way of doing
it.  Using svn-buildpackage doesn't seem possible right now, since
that tool is thought for packages that upload the whole source code,
and that's not really nice.

We might come up with a better way of doing it, eventually.

Adding new packages
=================

Other packages (as evolution-exchange or evolution-webcal) can be
added to the repository, as long as they follow the same structure. 
That would mean, adding one new dir to trunk, one to tags and one to
branches.

-- 
Besos,
Marga