First, please read the README file.

This file will explain how to install and run client (VSSExtractor) 
and server (CServer) programs.

WARNING : since VSSExtractor/Cserver project is in an early development
phase, installing might be a bit tricky. Please try to make it work
and send me feedback at vssextractor-devel@lists.sourceforge.net


1/ Installing the client program

Client program has been developed under Microsoft Windows 2000 environment, 
and should compile and run under any win32 platform. A binary distribution
of the client program is provided (VSSExtractor.exe), it will need 
Apache's Xerces DLL (Xerces-c_1_4.dll) to run correctly.

If you wish to compile the program, you will need to download and install
Xerces-C library from Apache (http://xml.apache.org), and to let your
C++ compiler and linker know where Xerces lib and include files can be
found.

Project (.dsp) and Workspace (.dsw) files are provided to compile the
client program under Microsoft Visual C++, along with a makefile to 
compile it under any command-line C++ compiler.

You will get an executable file named VSSExtractor.exe, place the config 
file (VSSEXtractor.ini) in the same folder than the executable and just
run it to start the conversion client.



2/ Installing the server program

Server has been developed under GNU/Linux 2.4, it should compile and run
under any distribution of GNU/Linux and should also be easily adaptable
to any standard UNIX-like system where CVS is available.

CServer sources come as a patch to CVS sources, so that a make in CVS
source tree will yield "cserver" program rather than "cvs" program.
Two methods are available to build cserver program :

FIRST METHOD :
  1) get and install CVS source distribution, version 1.11.1

  2) apply the patch cserver-0.7.1.patch found in cserver distribution,
  under /patch directory, onto cvs source tree :
		patch -p1 < ~/cserver/patch/cserver-0.7.1.patch

  3) move to top of CVS source tree, run :
 		./configure
  then :
		make 

  The subdirectory /src should contain the cserver program.


SECOND METHOD :
  1) get and install CVS source distribution, version 1.10 or higher and
  do a ./configure

  2) copy the sources files found in cserver distribution under /source 
  directory, to the /src directory in CVS source tree

  3) Edit your makefile so that it will consider the new files :
 	cserver.c
	file.c
	user.c
	servlog.c
	
	then change the name of the final program to cserver.

  4) run make
  

You will finally get a binary file named "cserver". Simply run it in a 
directory containing the config file cserver.conf, to make the
conversion server available.
cserver do NOT need any special privileges to process the conversion.
However, it should be run as a user who as write rights to the CVS
repository.


3/ Credits

Microsoft Windows, Microsoft SourceSafe, Microsoft Visual C++ are registered
trademarks of Microsoft corporation. All rights reserved.

CVS is an open-source project released under the terms of GNU General
Public License. For more info, see  http://www.cvshome.org .

Xerces-C is an XML parser part of Apache project, released under Apache
Software License, Copyright (c) The Apache Software Foundation.
For more info see http://xml.apache.org .




