This distribution contains the source code for the program

			LA_MML
			======


It is a program to convert LaTeX source files into FrameMaker
mml format (as defined in the documentation supplied with
release 2.1 or later).

Please read the document `man-page.tex' (a LaTeX file) or
`la_mml.1' (a troff file using the -man macros) for usage
details.

The program is known to run on Unix platforms and on the
Macintosh.  Unix installation *requires* access to an
ANSI C compiler.  (The Gnu C compiler, gcc, is recommended;
on Sun systems the Sun ANSI C compiler, acc, is suitable.)

The Macintosh installation requires use of Think C (previously
known as LightSpeed C), version 4.0 or later.

The source code in the FTP directory is provided in compressed
tar format.  To uncompress the files, follow these steps on a
Unix system:
    1.	create a directory to hold the source files;
    2.  move the file `la_mml.tar.Z' into that directory, and
	change your working directory to be that directory;
    3.	execute the command:
		zcat la_mml.tar.Z | tar xvf -
    4.	you may now remove the original `la_mml.tar.Z' file.

Actual creation of the la_mml program on Unix should involve no
more than typing the command `make'.  You may like to read the
`Makefile' before typing such a dangerous command, however.

There is only one explicit Unix pathname hard-coded into the
source code.  It is ``/public/lib/tex/inputs'' which appears
as part of the default value used for the TEXINPUTS environment
variable (used if TEXINPUTS has not been set by the la_mml
user).  If you wish to change that default value, then either
edit file `main.c' or compile `main.c' with the TEXINPUTSDFLT
preprocessor variable defined to the desired value.  E.g.,
    gcc -W -c -O -DTEXINPUTSDFLT=\".:/foo/bar:/rab/oof\"

Installation on the Macintosh platform should require no
explanation for Think C users.  The only information needed is
that the application uses the
	MacTraps, ANSI and Unix
libraries and that you have to split the program into two
segments.  Putting ANSI in one segment and everything else in
the other segment works.  (Note: do not select 4-byte integers
or do anything non-standard in your Think-C preferences!)
If you wish to browse through the source files with THINK C,
you should set the tab size of each file to 8 manually.  The
Macintosh code uses standard MacOS menus to set options and
locate files.  This is all achieved by programming -- you do
not have to apply a resource editor.


The program was formerly distributed as shareware.  The program
has now become sufficiently old that I have changed the status
to freeware.  


Please report bugs to me by e-mail ...
	nigelh@csr.uvic.ca


Requests for enhancements will also be considered, but only
simple enhancements are likely to get implemented.

    Nigel Horspool

    Department of Computer Science
    University of Victoria
    P.O. Box 3055
    Victoria, BC
    Canada  V8W 3P6


			    *********


Here is some additional information applicable to Silicon Graphics
platforms, but I suspect it may be helpful for other users too.
The information was supplied by David Grier (david@physics.att.com).



	INSTALLATION OF LA_MML on SILICON GRAPHICS MACHINES
	===================================================

I downloaded your LaTeX to mml filter today and got it running on
a Silicon Graphics 4D workstation.  I set it up as an automatic
filter for FrameMaker 2.0 and seems to work quite well.  For the
record, here's what needs to be done for the SGI platform:

Compile with cc and no CFLAGS.  The C compiler on SGI already
understands ANSI declarations.  After making the appropriate changes
in Makefile, make did the trick.

To make la_mml an automatic filter for FrameMaker 2.0 (the latest SGI
version) add the following lines

In /usr/frame/.fminit2.0/MifRead:

	*.tex) $5/la_mml < $1 | $5/mmltomif -L$6 -I$3 -I~ -I$4 >$2;;

    somewhere in the case statement.

In /usr/frame/.fminit2.0/suffixlist:

	<tex>

    at the end

Finally, link la_mml to an image in /usr/frame/bin:

    ln -s directory_of_choice/la_mml /usr/frame/bin/la_mml
