#
# Original Author
# Steve Spicklemire
# Silicon Prairie Ventures Inc. (SPVI)
#
# Significant Contributions by Shane Hathaway, Digital Creations Inc.
#
# Portions (Copyright (C) 2001, Mikael BERTHE, Alcove)
# 
# Disclaimer
#   
#   THIS SOFTWARE IS PROVIDED BY SPVI ``AS IS'' AND ANY EXPRESSED OR
#   IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
#   WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
#   DISCLAIMED.  IN NO EVENT SHALL SPVI OR ITS CONTRIBUTORS BE LIABLE FOR
#   ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
#   DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
#   GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
#   INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
#   IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
#   OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
#   ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
#   
# 
# 
# ZCVSMixin Installation
#
# Alcove, MiKael, 2001/05/16
# <mikael@fr.alcove.com>
# <mikael.berthe@efrei.fr>
#

                 INSTALLATION

1.  Unpack zope-zcvsmixin Debian package, or untar the zope-zcvs archive
    and restart Zope.
2.  Create two directories on the server: a "CVS repository" and a
    working directory.
    - Repository:
    Use the Zope server uid (for UNIX; www-data here):
    root# mkdir $path/$repository
    root# chown www-data:www-data $path/$repository
    www-data$ cvs -d $path/$repository init
    - Working directory:
    www-data$ mkdir tmp   # (somewhere...)
    www-data$ cd tmp
    www-data$ cvs -d $path/$repository import WorkDir Alcove reltag
    www-data$ cd ..
    www-data$ rmdir tmp
    www-data$ cd $path2
    www-data$ cvs -d $path/$repository checkout RepTravail
3.  Create a root ZCVS Folder in Zope:
    In the Zope Folder, create a CVS object (Add "CVS Folder").
    You will then have to answer some questions:
    - File System Root: root for the working directory (XML files will be
      created in this folder, and its sub-folders.
    - File System Repository: the real directory (for the current Zope
      Folder) relative to the "File System Root".
    - Password File: not tested by me (MiKael)...
    - Use Pass File: idem
    - Default Global Args: parameters for the cvs call;
      for example "-d /path/of/cvsroot".
    - Add directory to CVS Repository: when a ZCVS object is added,
      the matching FS directory will aitomatically be added to the
      CVS, by the ZCVSFolder product.
4. There are two ways to add a ZCVS object to a Zope sub-folder:
   a) Re-do step 3 in the sub-folder; then you should just have to
   confirm the settings.
   b) Use the "Create CVS Folders Tree" command, in the admin
   interface (CVS Actions pannel).  This will add every sub-folders
   automatically.
5. Archive documents (if there already are some) into CVS.
   Set recursive mode (in the admin interface), then select all and
   click on "Add Obj->CVS"...

# vim: set et sts=2 tw=73 comments=fb\:*,fb\:-,fb\:o ft=text:

