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)
| |
