Introduction
============

This is CAMAS or CAudium Mail Access System, a webmail for the Caudium webserver
which uses the IMAP protocol for now to access mail.

Camas is originally based on IMHO, see the CREDITS-IMHO file for more
informations on IMHO. Camas now has some major differences with IMHO because
it does not have the same goals and has more developer's time behind it.

Overview and goals
==================

What Camas is not:

. Easy to configure.
. For personal use.
. Known and developed with fashion languages.
. Good documented for the administrator.
. A strong community.

What Camas is:

. Design for professional use, Camas is mainly developed by companies either
  ISP or B2B ones. The first one want speed the second want features and
  templating.
. Maintained up to now.
. With unique features like total RXML templating, intelligent IMAP cache (
  intelligent meaning it pre fetch all it can), non blocking IMAP client,
  extensible with your own modules, fancy features like the ability to answers
  several mails with one click,...

Mailing lists
=============

The developers mailing list is camas-devel@caudium.net. You can use it to report
bugs, patch and technical ideas.
For other things you can use the general mailing list at camas-general@caudium.net.

Debugging
=========

Camas uses macros for speed and sanity reasons. This means that your copy of 
Camas may not have debug enabled by default, it's especially true for stable
release. To enable debug, start caudium with -DCAMAS_DEBUG or add
#define CAMAS_DEBUG in server/etc/include/camas/globals.h. You will then have
the choice of debug for each module in the configuration interface.

Installation
============

This version of Camas has been tested with Caudium 1.2 and Pike 7.2. It is
known to start with Caudium 1.3 and Pike 7.5, you can try with older versions
but it might not work as developers don't use older versions.

At the time of this writing (1.2.16 RC1), Camas has been tested with the 
following IMAP servers:

. WU-IMAP
. Courier-IMAP (best tested so far).
. Cyrus 2
. Dovecot

For more informations see the file INSTALLING.

For people upgrading from previous versions of Camas or IMHO, please see the
file UPGRADING.
