Welcome to ArchZoom
-------------------

ArchZoom is an Arch revision browser, a web based application that uses
tla and optionally revision library as a backend.

ArchZoom works with any web server and does not require anything special
to be installed on the system, except for tla and perl greater than 5.005
(perl 5.8.2 is just fine, for example).

How to install
--------------

Run one of the following commands:

	make install  # autodetects DocumentRoot if possible
	make install DocumentRoot=/home/apache/html
	make install UseSymlinks=1  # don't copy anything, use symlinks

This copies one file archzoom.cgi and creates one directory archzoom-data
inside the specified or autodetected DocumentRoot dir of your web server.
Alternativelly, symlinks are used instead of copying.

Then edit /etc/httpd/conf/httpd.conf or a similar file:

	* define *.cgi or just archzoom.cgi to be cgi-script, for example:
		AddHandler cgi-script .cgi
	* optionally use mod_perl to speed up archzoom.cgi

As a deamon user that runs web server (like "nobody" or "apache"):

	* configure archives you want others to browse from the web
	* optionally define revision library and populate it with
	  archive revisions you want to provide to your web users

Edit archzoom-data/conf/archzoom.conf and load archzoom.cgi into browser.

Hopefully, this is all. Enjoy.

-- 
Mikhael Goikhman <migo@homemail.com>
% tla get migo@homemail.com--Perl-GPL/archzoom--devel--0
