This is rtf2latex2e 0.263 beta by Ujwal Sathyam and Scott Prahl. It uses 
the RTF reader by Paul DuBois and converts RTF fles into the LaTeX2e 
format. Its main features are:

1. detects text style: bold, italic, color, big, small,...
2. reads embedded figures: PICT, WMF, PNG, JPEG,...
3. reads tables: simple to semi-complex
4. equations: reads out Equation Editor equations as pictures
5. symbols: converts most greek and math symbols
6. reads footnotes (not in tables yet)
7. support for use of the fontenc package
8. translates hyperlinks using the hyperref package

WHAT YOU WILL GET:
==================
If you expect a WYSIWYG reproduction of your RTF file, you may be 
disappointed. My main concerns have been translating the essential 
features of the RTF file such as characters, figures, tables, and 
equations (as pictures).  I have largely ignored visual formatting 
such as ruler positions, tabs (until I figure out a good way of doing 
this), paragraph indentations, and other fluff.  I have always expected 
the output LaTeX file to require manual editing to put the finishing 
touches.  I just want to make that task a little easier.  In my opinion, 
expecting a WYSIWYG reproduction is not practical and misses the point 
entirely.

Typeset the rtf2LaTeX2eDoc.tex for more information, or print out the 
rtf2LaTeX2eDoc.pdf file. They are in the documentation directory.

The file Release-notes.txt usually has more up-to-date info.

THE r2l-pref PREFERENCE FILE:
=============================
As of version 0.21, rtf2latex2e reads a preference file r2l-pref where 
you can specify various options such as:

1. ignoreRulerSettings: default=true; if set, all indenting information is
   ignored.
2. ignoreColor: default = true; if set, color information is ignored.
3. ignoreTextStyle: default = false; if set, text style is ignored.
4. useFontEncoding: default = false; a choice of encoding styles such as
   T1, OT1, LY1, etc.
   
There are other options to set paper size and margins. However, they 
will be ignored if ignoreRulerSettings is set to true.

The preferences in the Mac application can be accessed from the File menu.

THE r2l-head file:
==================
Here you can specify additional packages to be insered into the ".tex" file. 
If this file exists, rtf2latex2e will read it once for every input file.

INSTALLATION AND USE:
=====================
rtf2latex2e was developed on the Macintosh using DropUNIX for maximum 
portability to Unix. I have tested it on the Macintosh PowerPC, Linux 
(Intel), Linux (PowerPC), Solaris 2.6, and Windows 95/NT. Basically, 
rtf2latex2e should compile on any platform that supports a C compiler.

MACINTOSH:
----------
Macintosh users get a precompiled fat binary. Drop your RTF files on it. 
If you want to build your own binary, CodeWarrior project files are provided. 
You will need to get the DropUnix libraries to compile. Read the 
documentation and release notes for more details. The preferences can be 
accessed from the File menu.

If you are runnning MacOS < 8.5 on a PowerPC, put the files "Navigation" 
and "Appearance Extension" (in the folder "-> put into Systems Folder") in your Extensions folder in your System folder. Put the file "Appearance" into your Control Panels folder.


UNIX:
-----
Unix users need to build the binary using make. To start building rtf2latex2e, 
from the sources directory, type (superuser mode may be necessary for install):

make
make clean
make install

ON DEC Alpha systems, there may be some issues involved make barfing on the 
supplied Makefile:
  - there was an extra line containing just a tab character, and this resulted 
    in make aborting with the message 'null command'.  
  - Also the macro $^ is not available on DEC Alphas, nor is it mentioned in 
    'Unix in a Nutshell'. It should be replaced with $(OBJ).

make clean removes object files, make install copies the binary and the 
auxiliary files to the install directory that is specified in the Makefile. 
You can change the directory into which rtf2latex2e is installed by editing 
the variable INSTALL_DIR at the top of the Makefile. Default install directory 
is /usr/rtf2latex2e. You may need to become superuser to install into that 
directory. If you do not have superuser previleges, you can change the 
INSTALL_DIR to somewhere in your home directory, say $(HOME)/rtf2latex2e.

If you already have an existing rtf2latex2e installation, "make install"
might fail since it tries to create /usr/rtf2latex2e using mkdir. You have
two options:
1. remove the existing rtf2latex2e directory.
2. manually copy the contents of the present distribution to the the
   existing rtf2latex2e directory.

Finally, you will need to set the environment variable RTF2LATEX2E_DIR 
from within your shell. The variable has to point to the directory into 
which rtf2latex2e was installed. You can set the variable using 

export RTF2LATEX2E_DIR=directory (bash) or
setenv RTF2LATEX2E_DIR directory (csh)

in your .bashrc or .login file, whichever is read by your shell.

It is also convinient to add the rtf2latex2e directory to your search 
PATH or create a symbolic link to the binary in your /usr/bin directory.

To run rtf2latex2e, type:

rtf2latex2e <rtfFileName>

WINDOWS:
--------
Windows users get precompiled binaries of rtf2latex2e and rtfprep to be run 
from the MS-DOS prompt. If anyone needs to recompile either program, I have 
included CodeWarrior Pro 4 project files for both rtf2latex2e and rtfprep.

You will need to set the environment variable RTF2LATEX2E_DIR from within 
DOS. The variable has to point to the directory into which rtf2latex2e 
was installed. You can set the variable using 

SET RTF2LATEX2E_DIR=directory

in your AUTOEXEC.BAT file.

It is also convinient to add the rtf2latex2e directory to your search PATH in 
the AUTOEXEC.BAT file.

On my WinNT box, I found that I had to restart the computer for any changes in
AUTOEXEC.BAT to take effect. Silly...

To run rtf2latex2e, type:

rtf2latex2e <rtfFileName>


IMPORTANT: 
==========
rtf2latex2e needs to reside in the same directory as the following files:
*.map, *-sym, rtf-ctrl, TeX-map, r2l-pref.
The *.map and sym files are character set maps, rtf-ctrl is an RTF control word 
look-up table, and TeX-map is the output map file. r2l-pref is the preference
file.


LEGAL STUFF:
============
(c) Ujwal S. Sathyam and Scott A. Prahl, 1999

The author provides this software as is and does not take any responsibility 
for the consequences of running it (unless it is good, of course...). This is 
beta software, so treat it as such.

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You are encouraged to submit code corrections/enhancements to me. 

The writer and driver parts of the code are copyright Ujwal Sathyam.
The pict2eps conversion routines are copyright Scott A. Prahl.
The reader part of the code was written by Paul DuBois of the Univ. of 
Wisconsin Primate Center. The DropUnix framework was written by Ryan Davis 
of ZenSpider Software. The DropUnix framework is based on the DropShell 
application framework written by Leonard Rosenthol, Marshall Clow, and 
Stephan Somogyi.

The jpeg->eps conversion routine was adapted from Thomas Merz's jpeg2ps with 
his permission. jpeg2ps is available from http://www.ifconnection.de/~tm. Any 
legal stuff regarding jpeg2ps still applies to the jpeg->eps conversion routine
in rtf2latex2e. The following is quoted from the jpeg2ps README file:

Begin quote:
This software is free. You are granted the right to use and copy it. This
software may not be sold or bundled with any commercial package without
express written permission of the author. 

The author accepts no responsibility for damages resulting from the use of
this software and makes no warranty, either express or implied, including but
not limited to, any implied warranty of merchantability or fitness for a
particular purpose. This software is provided as is, and you assume all risks
when using it. 
End quote

AUTHOR CONTACT:
Ujwal S. Sathyam
setlur@bigfoot.com

Scott A. Prahl
prahl@ece.ogi.edu


