How to install from the released tarballs
-----------------------------------------

If you install from the development sources, read the next section first.
To install archzoom, execute:

	./configure

The ./configure script conveniently shows all installation locations.
Then just execute (probably as root):

	make install

Supply options to ./configure to change the installation locations.
For example, here is a pretty typical installation:

	./configure --prefix=/var/www/cgi-bin

When possible, the prefex is auto-detected from your Apache configuration.
Then one archzoom.cgi script and one archzoom-data directory are installed
into the Apache's DocumentRoot, i.e. /var/www or /srv/www on some systems.

If you know what you do, the installation may be split into more locations:

	./configure --prefix=/opt --bindir=/srv/www/cgi-bin --sysconfdir=/etc

These options are used to create rpm and deb packages:

	./configure \
		--bindir=/var/www/cgi-bin \
		--datadir=/usr/share \
		--sysconfdir=/etc/archzoom \
		--localstatedir=/var/run/archzoom \
		--with-cachedir=/var/cache/archzoom \
		--with-homedir=/etc/archzoom

For Debian, bindir is /usr/lib/cgi-bin; for SuSE it is /srv/www/cgi-bin.
Also, deb uses localstatedir=/var/run and the limit file archzoom-limit.

The configured local paths are stored in perllib/ArchZoom/Constants.pm.


How to install from the development sources
-------------------------------------------

Make sure you have not-too-old GNU autoconf and GNU automake packages.
Execute these 3 commands:

	aclocal
	automake -a
	autoconf

Once you have ./configure script, follow the first section instructions.
If you are a developer, you usually only need to issue "make" to regenerate
all auto-generated files at any point. In some rare cases, you may need to
execute these 3 commands again, and then "./configure".


For adventurers only
--------------------

If you don't want to install stuff, there is a mode that setups 2 innocuous
external symlinks (archzoom.cgi and archzoom-data) into the archzoom tree.
To activate this installation mode, run:

	make install UseSymlinks=1  # don't copy anything, setup 2 symlinks

In this mode, the separate confdir, statedir and cachedir are not used,
everything is done inside the archzoom tree itself. You may need to teach
your web server to honor symlinks.

