This is a 16-bit MSDOS executable of MultiMail v0.46. It identifies
itself as "MultiMail/XT" in tear lines.

I've copied the basic Unix documentation to MSDOS-format text files here,
but the full source code is available in a separate archive.

The first thing MultiMail will do when run is to look for its config file,
MMAIL.RC. It will look for an environment variable, MMAIL, to specify a
directory. If that's not defined, it will look for HOME; and finally, if
neither is defined, it will use the current directory.

If HOME is used, MultiMail will by default generate a directory "mmail"
underneath that, and place its files and directories there; otherwise
they'll go directly into the directory specified by MMAIL, or the current
directory. (This distinction in behavior between HOME and MMAIL is new in
version 0.45.) After the default MMAIL.RC is created, and before the paths
are actually created, you have the opportunity to edit them.

Temporary files and directories are created under the directory specified
by the "TempDir" line. ("TMP" and "TEMP" environment variables are
no longer used.) "TempDir" defaults to the same value as "mmHomeDir".

In addition to the MultiMail package itself, you'll also need InfoZip or
PKZIP (and/or LHA, ARJ, etc.) to uncompress the packets and compress the
replies. InfoZip is available from:

    http://www.info-zip.org/

PKZIP is at:

    http://www.pkware.com/

PKZIP is the default for DOS; InfoZip is the default for other platforms.
The programs should be installed somewhere in the PATH; otherwise, the
full path must be specified in MMAIL.RC.

This package includes some example color schemes, with ".col" extensions.
How or whether you install these is up to you. (If you want to use them, I
suggest putting them in your "mmail" directory. To select one, alter the
"ColorFile" keyword in MMAIL.RC to point to it.)

In the MMAIL.RC, I've added a keyword unique to MultiMail/XT, "swapOut".
This controls whether or not it attempts to swap itself out of memory (via
SPAWNO) before executing an external program (archiver, editor, or command
shell). The default is "Yes". It will first attempt to swap to EMS or XMS
memory; if that's not available, it will try swapping to disk. I've
included the option to supress this in case you want to run it on a
floppy-based system, or other system with very limited disk space. (The
swap to disk would occur before the packet was extracted, and might make
it impossible to extract it.) But if you have adequate EMS or XMS, leave
this on.

Unfortunately, the rest of the program does not (yet) know how to use EMS
or XMS. So unlike other ports of MultiMail, MultiMail/XT is severely
constrained in the memory available to it. It will read only as much of a
message as will fit in memory. (Early versions of this port were limited
to 64k per message, but this is no longer true.) Even so, it may shut down
with an "Out of memory" error sometimes. (The other ports do, too, but
much less often.) If that happens, you can go back, skip that item next
time, and still read the rest of the packet.

You can switch from direct video to BIOS writes by setting an environment
variable, "PDCURSES_BIOS". (Any value will do; I normally use "set
pdcurses_bios=y". To return to direct video, type "set pdcurses_bios=".)

This was compiled with Turbo C++ 3.0, and linked with Ralf Brown's SPAWNO
library and PDCurses 2.4. See http://pdcurses.sourceforge.net/ and
http://www.cs.cmu.edu/afs/cs.cmu.edu/user/ralf/pub/WWW/files.html for more
information.
