$Id: README,v 1.3 2003/05/03 21:28:11 ianmacd Exp $

INTRODUCTION
------------

rit is the Ruby IMAP Tool, written to assist in the copying of mailboxes from
a system running Cyrus IMAP to a Mirapoint message server.

The software has been fairly heavily tested using Cyrus IMAP 2.1.12 and
version 3.2.3-GA of the Mirapoint operating system. A few system I/O errors
have occurred during that testing, but all known logical bugs in the program
have now been eliminated.

The software has not been tested with the University of Washington IMAP server
and is unlikely to work, due to namespace issues. This may be investigated for
a later release. If you are in a position to test such a set-up and supply a
patch, I would be glad to hear from you.


INSTALLATION
------------

To install the software, type 'make install'. If you want the program to be
installed somewhere other than /usr/local, type 'make PREFIX=<path> install'.

rit has just one prerequisite (other than Ruby itself being installed, of
course). That is the installation of the Ruby/Password library, which can be
found at http://www.caliban.org/ruby/.


SEE ALSO
--------

rit home page:	      http://www.caliban.org/ruby/
IMAP protocol v4rev1: http://www.ietf.org/rfc/rfc2060.txt
Cyrus IMAP:	      http://asg.web.cmu.edu/cyrus/imapd/
Mirapoint products:   http://www.mirapoint.com/products/index.shtml
UW IMAP:	      http://www.washington.edu/imap/
