CVS Migration
last modified
2007-03-14
Describes how to move from Gamera 2.x to Gamera 3.x.
Gamera 3.x is now at the HEAD of CVS, and the older Gamera 2.x is in a branch called 'gamera2'. The Gamera 3.x documentation is now at the default place on the website:
http://dkc.jhu.edu/gamera/html
and the Gamera 2.x documentation has been moved to:
http://dkc.jhu.edu/gamera/2/html
There are also file releases of the 2.x and 3.x series available as source tar.gz . I don't plan to release binaries at this time.
UPDATING INSTRUCTIONS
---------------------
After updating your local CVS copy, a clean build is recommended. Do:
python setup.py clean
before rebuilding. It will also need to uninstall Gamera by removing the "gamera" subdirectory of your Python "site-packages" directory.
Below are instructions describing the most common scenarios.
Clean checkout
--------------
If you don't have any local changes to your Gamera install, the easiest way to continue to receive updates is to start with a clean checkout:
To get Gamera 3.x:
cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/gamera login
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/gamera co -P gamera
To get Gamera 2.x:
cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/gamera login
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/gamera co -P -r gamera2 gamera
Going from Gamera 2.x - Gamera 3.x
----------------------------------
cvs update -dP
...from the root of the Gamera source tree should automatically move your Gamera 2.x to Gamera 3.x. Since the changes are "extreme" to say the least, merging Gamera 3.x into any local changes you may have will be difficult. Don't hesitate to ask for assistance with this. Be sure to do a clean build.
Continuing to work with Gamera 2.x
----------------------------------
If you wish not to upgrade, you can continue to work on Gamera 2.x by updating to the 'gamera2' branch:
cvs update -dP -r gamera2
Continuing to work with Gamera 3.x
----------------------------------
If you're running Gamera 3.x now, it means you got it from the 'gamera3' branch. Since 'gamera3' is now on the MAIN branch, you'll need to join with it in order to continue to get updates in the future:
cvs update -dP -j MAIN