IMP CVS version
Copyright 1998 Charles J. Hagenbuch <chuck@osmos.ml.org>

This code is licensed under the GNU Public License.
See the file COPYING in this directory.

----------------------------------
Requirements for IMP CVS snapshots
----------------------------------

 * php 3.0.3 or greater with IMAP support (and a database if you want
     prefs/addressbook).
 * a database (currently mysql/postgresql/oracle) for the abovementioned
     addressbook or pref saving, although using the prefs and addressbook is
     currently optional.
 * a web server, preferably an SSL web server so that IMP can use a secure
     connection.
 * an IMAP server to connect to.


----------------------------------------
Installation Notes for IMP CVS snapshots
----------------------------------------

index.html is the root of the frame system. If you want IMP to use a secure
connection (SSL), then you need to somehow make sure that users access IMP
as https://your.server.here/your/path/to/imp/, not as http://blah... If a
server redirect or similar solution won't work for you, then change the
links in index.html to be abolute links starting with https:// - this will
force secure connections. Do note that this will completely prevent insecure
connections to IMP, whether you wish to allow them or not.


lib/imp.lib.php3 and config/defaults.php3 contain a number of defaults that
you'll need to configure for your system, such as the default IMAP server,
whether or not users can pick a different server, the colors, etc. The two
files are fairly well documented, so you should be able to pick out what you
need to change fairly easily.


If you want to use the standalone cgi version of php3, you have a few
options. If you're running Apache, you should be able to add this line:

  Action application/x-httpd-php3 /cgi-bin/php    # or where your php cgi lives

to srm.conf (possibly this will work for other servers as well, but I don't
know), as well as the standard:

  AddType application/x-httpd-php3 .php3
  AddType application/x-httpd-php3-source .phps   # this one is optional

... and then the php cgi should automatically handle .php3 files.

Or, you can change the $default->root_url variable (in defaults.php3) to
point to "/cgi-bin/php/path/to/imp/files", and everything *should* be put
through the cgi automatically. Please report any instances of this not
working to me, because $default->root_url may not be used in all the places
it needs to be used in.


---------------------
Getting Help with IMP
---------------------

There is a web page for IMP at http://osmos.ml.org/projects/imp/. There are
also two mailing lists. One is the general IMP list, for development,
discussion, etc. It is imp@osmos.ml.org, and you can subscribe by sending an
empty email to imp-subscribe@osmos.ml.org.

The other list is the CVS commits list, and most of the mail on it is
automatically generated announcements of changes to the CVS code. Developers
should defintely be on it, and anyone else who is curious about the status
of IMP development is welcome to join it by sending email to
imp-cvs-subscribe@osmos.ml.org.

There are also web archives of both mailing lists. See, respectively:
  http://osmos.ml.org/archive/imp/
  http://osmos.ml.org/archive/imp-cvs


---------------------------------------
---------------------------------------

Enjoy, Chuck Hagenbuch and the IMP team
chuck@osmos.ml.org
