ML top-level README

	Please look in the "docs" directory for installation and
related developer notes. The program itself lives in "src". The file
"docs/README.install" should get you started. 
	The "imap" directory contains the IMAP toolkit (often referred
to as the "c-client" toolkit in associated documents), from the
University of Washington. The c-client toolkit must be built before
the ML program can be built, as there are dependencies to many of its
files.
	The "aux" directory contains programs and scripts which are
used to automatically generate some of the source files.
	The "bindist" directory is included with binary release of the
program and includes other files which may need to be installed on the
system for proper functioning.
	The "Xew" directory contains the source for the EuroBridge
widget toolkit. It and the imap toolkit must be built before building
ML itself. They each have their own documentation if you run into
trouble.

	Questions concerning ML should be addressed to
"ML@CAMIS.Stanford.EDU".

Binary Releases
---------------

	If you have received a binary release of the program, install
the IMAP server (imapd) if required, as described later in this document.

	You should have obtained a support file package to go with
your binary release. This is necessary(!). If you don't have it, grab it
from "ftp://ftp-camis.stanford.edu/pub/ml/BINARY.SUPPORT.{version}.tar.Z".

	The ML binary should be named or linked to "ml" and copied to
somewhere useable like /usr/bin/X11, the files in the lib directory go
into /usr/local/lib/ml, and lib/ML.ad should be installed as
"/usr/lib/X11/app-defaults/ML", OR whever you have your app-defaults
stored. You DO NOT need to install the app-defaults file unless you
want to set appropriate configuration information for your site for
all new ML users.

	If you don't have root privilege, you can put all the lib
files anywhere you wish. Set your preferences when you first
start the program to locate them correctly. You can set various X
environment variables to find the resource file (which should be
renamed from "ML.ad" to "ML", in whatever location you end up
with). The IMAP server requires root privilege to install
correctly. BUT, you may still run the program. When asked for an IMAP
server, leave the field blank, and only supply a mailbox name. This
version of the program should work fine without an IMAP server.

	If you are running SunOS or Solaris, or your Motif library is an
"add-on" to your basic operating system, look over the README in the
"bindist" directory; and see if any of the notes apply to you. 

	DEC OSF/1 and Linux users may wish to set personal or system 
defaults to locate a suitable font, which will otherwise display a warning when
the program first starts. Consult the file "lib/ML.ad.ORIG" for font
definitions used in the program. There are also some related notes in
the FAQ at http://www-camis.stanford.edu/projects/imap/ml.


Installing the imap server (Binary releases only)
-------------------------------------------------

As root on the mail server system:

# cp imapd/imapd /usr/local/etc/imapd
# chmod 755 /usr/local/etc/imapd

Add the appropriate entries in /etc/services and /etc/inetd.conf

/etc/services:
imap	143/tcp

/etc/inetd.conf:   (Check your system documentation, this changes).
imap	stream	tcp	nowait	root	/usr/local/etc/imapd	imapd

Rebuild NIS if applicable, to update the "services" map, and restart
inetd with "kill -HUP {pid}", where {pid} is the process ID of the
running inet daemon.

If you wish to use automatic mailbox login (using rsh methods):

# cd /etc
# ln -s /usr/local/etc/imapd rimapd

(Leave out the -s if your system doesn't support it for creating
symbolic links.)

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