======================================
INSTALLING SUBVERSION
A Quick Guide
======================================
$LastChangedDate$
Contents:
I. BUILD REQUIREMENTS
II. INSTALLATION
A. Building from a Tarball or RPM
B. Building the Latest Source under Unix
C. Building under Unix in Different Directories
D. Installing from a Zip or Installer File under Windows
E. Building the Latest Source under Windows
III. BUILDING A SUBVERSION SERVER
A. Setting Up Apache
B. Making and Installing the Subversion Server
C. Configuring Apache for Subversion
D. Running and Testing
E. Alternative: 'svnserve' and ra_svn
IV. PLATFORM-SPECIFIC ISSUES
A. Windows XP
B. Mac OS X
V. PROGRAMMING LANGUAGE BINDINGS (PYTHON, PERL, RUBY, JAVA)
I. BUILD REQUIREMENTS
==================
Subversion depends on a number of third party tools and libraries.
Some of them are only required to run a Subversion server; others
are necessary just for a Subversion client. This section explains
what other tools and libraries will be required so that Subversion
can be built with the set of features you want.
On Unix systems, the './configure' script will tell you if you are
missing the correct version of any of the required libraries or
tools, so if you are in a real hurry to get building, you can skip
straight to section II. If you want to gather the pieces you will
need before starting out, however, you should read the following.
If you're just installing a Subversion client, the Subversion
team has created a package containing the minimal prerequisite
libraries (Apache Portable Runtime, Neon, and Zlib) called the
"dependency package" tarball or zipfile. You should be able to
find it at the same place that you downloaded the Subversion
tarball itself from. (Note that this is new as of Subversion
1.4.0; previous releases packaged the dependencies in the same
tarball as Subversion itself.) If you don't have these
libraries installed already, you can simply unpack the
dependency package "on top of" the Subversion package; for
example, if you are using a .tar.gz bundle on Unix, you could
type:
$ tar xzvf subversion-1.x.x.tar.gz
$ tar xzvf subversion-deps-1.x.x.tar.gz
$ cd subversion-1.x.x
This will place 'apr', 'apr-util', 'neon', and 'zlib'
directories directly into your unpacked Subversion distribution,
where they will be automatically configured and built by
Subversion's build process.
Note: Because previous builds of Subversion may have installed older
versions of these libraries, you may want to run some of the cleanup
commands described in section II.B before installing the following.