This file contains hints for installing Columbia MM.

If you're reading this file, you've probably untarred MM already.  If
not, you will want to use the command "tar xf mm.tar" to untar the
"mm" directory (and probably the "ccmd" one as well).  (If you have
mm.tar.Z, you will first need to use the compress(1) program to
uncompress it into mm.tar.)

Unless you picked up mm-only, included with MM is the CCMD package.
You will need CCMD to compile MM, and often you will need the most
up-to-date version of CCMD.  Since MM is the first major CCMD
application, it turns up a lot of CCMD bugs and encourages (and
depends on) a lot of the improvements.  CCMD files will be put in the
ccmd subdirectory, and MM files in the mm subdirectory.

The first thing to do (after tar xf) is to specify your OS type.  This
must be done for both CCMD and MM.  For CCMD, just say "make
system-type" (i.e. make bsd, make svr3).  See the Makefile for
supported system types.

MM knows about several different systems, in files called "s-xxx.h".
Currently, we have about a dozen of them, hopefully one in your size.
However, if there is not a file for your OS type, simply modify one
that does exist.  These files contain copious comments on all the
#define's within them, so if you know your system fairly well you
should have no trouble creating the appropriate file.

Once you have the correct s-xxx.h file, you should edit the name into
config.h (replace whichever s-xxx.h file is there).

MM comes with several supporting files and programs, which must be
available to anyone running MM.  In addition, it uses several programs
that you should already have.  The file pathnames.h contains default
filenames for these, so MM can find them.  To override these defaults,
add #define's to config.h.  (It is intended that you should only have
to modify config.h to install MM.)  Defaults for the editor, speller,
and other non-MM programs can also be set in your system-wide init
file or by individual users.

If your system has curses, but not termcap, you will have to modify
the makefile to use the line with "-lcurses".

Now, just run "make" to compile mm and supporting programs.

At this point, you may want to run sys-prof (the system profiler).
This program will ask various questions, and set up a basic
system-wide initialization file in "mm.conf".  You may modify this
file if you like.  (Everything that you set in mm.conf can be set as
defaults in MM source files, but this avoids having to edit source
files.  Also, you will not have to reinstall this file when you get a
new version of MM.)

MM requires a lot of library files, including a tree full of help
screens.  These library files are placed according to the "LOCLIB"
variable in the Makefile, which we set to /usr/local/lib/mm.  (If you
change this, you'll want to override the definitions in pathnames.h --
in order to only modify config.h (as noted above), just put the new
definitions in there.)  There is also a "BIN" variable in the Makefile
for the two binaries MM installs.

Once these are satisfactory, you (should) just have to run "make
install" or "make re-install" (GNU's gmake is suggested).  Making
"re-install" differs from "install" in two ways.  First, it leaves
your existing "mm.conf" file intact.  Second, it tries to update only
the help files that have been changed.  (Unfortunately, this may not
work correctly with some versions of make.  But since you are probably
just installing the whole help tree, you can use "make HELP" and then
"make main-install".)

mm.conf and mmail.el are text files that contain explanations of
themselves.  The help directory tree contains MM's internal help
screens. "movemail" is similar to the GNU emacs movemail, but we
strongly suggest you use our movemail and not the GNU one, since there
are security holes in the GNU version.  (However, we DO recommend that
you use GNU emacs...)  Our /usr/spool/mail directory is in group
"mail", and movemail is setgid'd to be in the mail group.  (It can
work without the setgid bit, but not as elegantly.)

If you have users migrating from DEC20s they will want to use the
mm-trans program (that "make install" installed).  Also, you should
install the man pages, mm.1 and mm-trans.1, in your man tree as
desired.

Note: MM is copyright (c) 1986, 1990 by The Trustees of Columbia
University in the City of New York.  Permission is granted to any
individual or institution to use, copy, or redistribute this software
so long as it is not sold for profit, provided this copyright notice
is retained.
