There are three types of installations:
1. Those who have just gotten this file from an archive, email, etc,
   and have NEVER used this program.  Instructions for you follow.
2. Those who've used this program before, and have added their own
   modifications to the program.  This second type of installation
   is accomplished by typing "make install".
3. Those who want to customize this program for local Framemaker templates.
   See below.

The following applies to the first type of installation:

I've run the program on a Sun 3/50 using SunOS (Berkeley UNIX).  The
program is set up for Berkeley UNIX; it may run without modification on
some other Unixes.  It expects Framemaker 2.0.

To install this program, create two new directories (using mkdir), one
that will be relatively private and can be used for development
(so you can modify the filter and test those modifications)
and one for the final version that everyone will use in day-to-day work.
The former is called the "development directory", while the latter
is called the "final directory".
The final directory should be accessable to all
(using chmod ugo+rx final_directory_name).

Copy or move the archived file into the "development directory" and
unarchive it.  Unarchiving is done by editing the file so
that the "CUT HERE" line and everything ABOVE it is deleted,
then executing  "sh <YOUR_FILE_NAME_HERE"

Edit the file "Makefile" using any text editor (such as vi or emacs).
On the line that says
DEVELOPMENT=/usr04/wheeler/framemm
change /usr04/wheeler/framemm to the "development directory" name.
This should be the same directory the Makefile currently resides in.
The line that says
FINAL=/usr01/wheeler/framemm
should be edited to the "final directory" name which will be used
by all normal users of the filter.

Save the Makefile file, leave your editor, and type:

make firsttime


When it's finished you'll have files in your final directory for all to
use, plus the files in a development directory so you can modify and
test new versions to account for local customs.


To make the translation automatic on any file ending with .mm,
cd to the .../frame/.fminit2.0 directory which is used by Framemaker.
Add to the file MifRead the following text in its
case statement (adding this text may require special access privileges):

         *.mm) /usr01/wheeler/framemm/mm2mml <$1 | \
              $5/mmltomif  -I$3 -I~ -I$4 >$2  ;;

Replace the phrase /usr01/wheeler/framemm  with your "final directory" name.
In the same .fminit2.0 directory add to the end of the file
"suffixlist" this one line so that the ".mm" suffix will be considered
special:
<mm>


Once you've installed the translator
you may want to customize it for local templates.
The file troffmm.mml can be easily modified to account for local
customs. Also, the file mm2frame.awk includes some lines near the
top to allow for customizing the default paragraph name, as well
as how headings are produced.



--- David A. Wheeler
    wheeler@ida.org