TtM README file.
________________

This package contains the C source distribution of TtM, a TeX to
(HTML and) MathML translator.

TtM is based on the highly successful TtH TeX to HTML translator. But
instead of using HTML tables for rendering mathematics, TtM uses
MathML presentation tags, embedded inside the <math> .... </math>
construct.

Copyright License
_________________

TtH and TtM are copyrighted by their author, Ian H Hutchinson (c)1997-2011.  

You are hereby freely licensed to use this software under the terms of
the GNU General Public License, version 2, published by the Free Software
Foundation, a copy of which is enclosed in the file license.txt.

The software comes WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Installation
____________

When you have the package downloaded on to your own disk,
extract the archive by executing 
	tar xzf ttmC.tar.gz
from the command line.

Enter the directory constructed, where you will find the extracted files
	cd ttmC

If you are on a Linux or other UNIX system, install the program
executables by executing from the command line
	make
and as root
	make install
This will copy files to appropriate directories. The directory
/usr/local/bin should be on users' path.

Alternatively, the steps carried out by ttminstall can be done by
hand: compile the program by something like
	cc -o ttm ttm.c
and copy ttm to somewhere on your path.

Running TtM
___________

Run TtM translation in the following ways; 

either from the command line type the command line:
	ttm >outputfile.html <inputfile.tex [switches]

or from the command line type 
	ttm inputfile [switches]

In the first case you can call the output file anything you want.  In
the last two cases an HTML file with the extension .html will be
created.

Icons are provided for installation under popular graphical user interfaces.

Remember, MathML is not natively supported by any of the versions of
the popular browsers up to present. Therefore they will not render the
results of your translations without browser configuration. 

The script file ps2gif is for image conversion.  It will be called
automatically by TtM when given the -e1 or -e2 switches. However,
ps2gif depends on your having a number of other utilities on your
computer. Most standard linux installations have these
utilities. Therefore, although we can take no responsibility
whatsoever for the utility of ps2gif, it will usually work. Similarly
the script latex2gif which depends on ps2gif and LaTeX will usually
work but again we cannot take responsibility for it.