Aamp-subversion

  This is an implementation of subversion to AmigaOS 4. Subversion is a
  free/open source version control system (VCS). Subversion manages files and
  directories, and the changes made to them, over time. This allows you to
  recover older versions of your data or examine the history of how your data
  changed.

  You need an already installed "AAMP" package (native version) before you can
  install this software. AAMP is available on OS4-depot.

  Why AAMP? Subversion uses the utility libraries of the web server Apache.
  For this port of subversion the already ported libs for AAMP were used.
  Additionally the subversion package includes two Apache modules, which are
  now integrated in the Apache binary.

  Important: You are NOT forced to launch the Apache web server to use the
             subversion tools!


  Homepages: http://subversion.apache.org
             http://httpd.apache.org


  Content
  -------

   1. Included programs
   2. Included Apache modules
   3. Configure the SVN Apache modules
   4. Configure the Apache DAV module
   5. Documentation
   6. Important files and directories
   7. Known problems
   8. Bug reports
   9. Installation
  10. Donations
  11. Thanks to...


1. Included programs
--------------------

  * svn

    The command-line client of Subversion.

  * svnadmin

    svnadmin is the administrative tool for monitoring and repairing your
    Subversion repository.

  * svndumpfilter

    A command-line utility for removing history from a Subversion dump file by
    either excluding or including paths beginning with one or more named
    prefixes.

  * svnlook

    A command-line utility for examining different aspects of a Subversion
    repository. It does not make any changes to the repositoryit's just used
    for peeking.

  * svnserve

    Allows access to Subversion repositories using Subversion's custom network
    protocol (svn://).

  * svnsync

    The Subversion remote repository mirroring tool. Put simply, it allows you
    to replay the revisions of one repository into another one.

  * svnversion

    A program for summarizing the revision mixture of a working copy. The
    resultant revision number, or revision range, is written to standard output.

  * Bonus: cadaver

    A WebDAV client for the command-line.
    For more informations call "cadaver --help" or open the man file
    "AAMP:Common/share/man/man1/cadaver.1" (e.g. with "Next").


2. Included Apache modules
--------------------------

  From the Subversion package:

  * mod_dav_svn

    Provides Apache configuration directives for serving Subversion reposi-
    tories through the Apache HTTP Server.

  * mod_authz_svn

    Provides Apache configuration directives for configuring path-based authori-
    zation for Subversion repositories served through the Apache HTTP Server.


  Additional modules from the Apache web-server package:

  * mod_dav

    This module provides class 1 and class 2 WebDAV ('Web-based Distributed
    Authoring and Versioning') functionality for Apache.

  * mod_dav_fs

    Acts as a support module for mod_dav and provides access to resources
    located in the server's file system.

  * mod_dav_lock

    This module implements a generic locking API which can be used by any
    backend provider of mod_dav.


  For more informations please have a look at the Apache online documentation.
  (Call "http://localhost/manual" in a browser while the Apache web-server is
  running).


3. Configure the SVN Apache modules
-----------------------------------

  To activate both SVN modules, the following lines must be added to the file
  "AAMP:Apache/conf/httpd.conf" (preferential after the line "LoadModule
  php5_module ..."):

    LoadModule dav_svn_module     modules/mod_dav_svn.so
    LoadModule authz_svn_module   modules/mod_authz_svn.so

  Afterwards you must tell Apache the location of the SVN repository, which
  should be accessible through the web-server. To add the example repository
  "AAMP:Subversion/example-repository", please add these lines to the configu-
  ration file "httpd.conf":

    <Location /repos>
      DAV svn
      SVNPath /AAMP/Subversion/example-repository
    </Location>

  After a relaunch of the web-server, the repository is accessible through the
  URL

    http://localhost/repos

  Attention: With this simple configuration the access to the repository is not
             safe! See chapter "Documentation" to get more informations.


4. Configure the Apache DAV module
----------------------------------

  Additionally to the SVN modules, you can configure WebDAV access to a direc-
  tory using the Apache DAV module.
  Here is a simple example, which must be added to the configuration file
  "AAMP:Apache/conf/httpd.conf":

    DavLockDB /AAMP/Common/var/DavLock

    <Location /dav>
      Order Allow,Deny
      Allow from all
      Dav On
    </Location>

  This gives access to the directory "dav" relative to the document root direc-
  tory (DocumentRoot).

  Attention: With this simple configuration the access to the directory is not
             safe! For more informations please have a look at the Apache online
             documentation. (Call "http://localhost/manual" in a browser while
             the Apache web-server is running).


5. Documentation
----------------

  An English and a German version of the O'Reilly Media book "Version Control
  with Subversion" is included in this package (see directory
  "AAMP:Subversion").

  You can find other translations on "http://svnbook.red-bean.com".


6. Important files and directories
----------------------------------

  * "AAMP:Subversion"

    Here are the specific files of Subversion including an example project and
    an example repository.

  * "AAMP:Common/Home/root/.subversion"

    In this directory the user defined configuration files are located.


7. Known problems
-----------------

  * If you launch the SVN server "svnserve" with the "-d" option (daemon mode),
    no new background process will be created. Please use the Amiga command
    "run" for this.

  * Maybe you can run into trouble, if you use repositories, which were created
    with the previous port of Subversion 1.1.4. The props "amiga:protection" and
    "amiga:comment" introduced in this version are not supported.


8. Bug reports
--------------

  Please send bug reports to "eds()rz-online.de" or post them to the bug tracker
  on OS4-depot.


9. Installation
---------------

  Doubleclick on the "Install" icon in the unpacked AAMP subversion package to
  install the data into the installed AAMP package. Everything will be installed
  automatically. Please follow the instructions of the installer script.


10. Donations
-------------

  If you like to support my work, you can make a donation by using paypal:

   http://www.schwan-clan.de/amiga/Donate.html

  Thanks!


11. Thanks to...
---------------

  ... René Thol (idea and beta testing)