Installation

 Dependency Installation

   first of all you need to have subversion installed on the server
   along with the python bindings for the version of python being
   used with zope. its highly recommend to use your platform's package
   manager to do this as compiling by hand is a tedious task.

   here are my notes on compiling by hand.

     - download the latest tarball, download the applicable bdb, 
       swig, and apache, and additional dependencies
       as noted in the svn install file.
 
     - setup a sandbox for installing svn and its dependencies
       into. as an example here's how i configured httpd and svn
       for a sandbox in /opt/svn::

           ./configure --prefix=/opt/svn \
                       --with-ssl \
                       --enable-ssl=/usr/lib/ssl \
                       --enable-maintainer-mode \
                       --enable-dav \
                       --enable-so \
                       --with-dbm=db4 \
                       --with-berkeley-db=/opt/svn/ \
                       --enable-deflate \
                       --enable-proxy 
           
           ./configure --with-apr=/opt/svn/ \
                       --prefix=/opt/svn \
                       --with-apr-util=/opt/svn/ \
                       --with-ssl \
                       --with-berkeley-db=/opt/svn/include:/opt/svn/lib \
                       --enable-maintainer-mode \
                       --with-apxs=/opt/svn/bin/apxs \
                       --with-swig=/opt/svn
       
   after you have subversion installed, installing the cmf svn
   browser is easy ;-)

   first you have to have zope2.6+, python2.2.0+, and CMF1.4
   installed and an instance of a cmf portal site. the skin currently
   has been tested only with plone 2.
 
 Product Installation

 
   go to the root of the portal site in zope management interface
   and add an external method with the following::
 
     Id: install_browser
     Module: CMFSubversion.Install
     Function: install

   then click on the test tab to finish the installation.  

   alternatively you can use the cmfquickinstaller tool to perform
   the installation.
   
   after installation, from within the content management interface
   you can now add a cmf subversion browser. 

   after adding a browser, click on its edit action to configure it
   the subversion db path, should correspond to a repository location
   on the file system, the browser does not support remote browsing 
   at this time (its a horrible overhead anyways, imo). the repository
   path should correspond to a directory in the repository that you 
   want to set as the root of the browser.

 Running the Tests

   you can verify that everything is working
   by running the unittests. this requires the installation of the
   "ZopeTestCase package":http://www.zope.org/Members/shh and setting
   the INSTANCE_HOME and SOFTWARE_HOME enviroment variables.

   in order to test the browser, a repository must be created to
   test against. running the makeTestEnv.sh shell script in the 
   tests directory will create an appropriate repository. This must
   be done before running the unit tests.

   the unit tests can now be run via

     python test_Core.py

