Packaging CalCore
=================
There are three major ways of packaging CalCore; make_pkg, zpkg and svn export.

Nuxeo make_pkg
--------------
This is the primary packaging operation. In most cases you want to run this
before any other type of packaging. Nuxeo make_pkg willincrease the version
number, make a tag in the svn for the new version, make CHANGES.txt, 
HISTORY.txt and VERSION.txt files, create a tgz package and update the CHANGES,
HISTORY and VERSION files accordingly.

The result is a file, CalCore-x.x.x.tgz that includes the CalCore product.
This can be installed either with distutils or as a Zope 2 Product.


Zope corp zpkg
--------------
zpkgtools is a set of tools to create distributions. It's quite complex, but
that is due to it being used to create the very comples Zope distributions.
The benefit of zpks is that it can create a package that includes all 
dependencies. Is it therefore used to create the CalCore distribution
intended for non-Zope usage, as the files will include versions of Zope
packages.

zpgktools can be checked out from svn://svn.zope.org/repos/main/zpkgtools/trunk

You install it and run it with 
  zpkg -C BUILD.pkg -vx.x.x
where x.x.x is the version number. 

The result is a file, CalCore-bundle-x.x.x.tgz that includes CalCore and all 
it's dependencies.  It can only be used for non-Zope installations.


svn exports
-----------
For Zope distributions outside of CPS, you can simply svn export all the 
products that is needed (CalCore, iCalendar, Five, CalZope, and maybe
CMFonFive, CPSonFive and CPSSharedCalendar). You can then create a 
tgz of these exports.

