README for Frame EPSF Converter version 2.0

This directory contains a single short Macintosh application which converts
Macintosh Encapsulated Postscript Files (EPSF) into a form which can be
read directly by FrameMaker running on Unix workstations. In particular, its
main function is to convert the "preview image" which is stored as a Macintosh
QuickDraw picture into an ASCII hex bitmap which can be interpreted and 
displayed directly by FrameMaker. Files that are converted conform to Addobe
Encapsulated PostScript structuring convention 2.0. Adobe refers to files 
using this all-text-with-preview format as "EPSI."

                          ------------------------

Since there are many ways to transfer files between a Macintosh and a UNIX
workstation, we provide the same file in several different forms. You should
use the files compatible with the communications software available at 
your site. There are four directories. Each contains the file(s) needed to
transfer the Frame EPSF Converter application:

BinHex: This file was generated using BinHex 4.0 and is an encoded ASCII text
file. This is the method usually used to transfer Macintosh binaries over
USENet. This should be transfered to the Mac as a text file and then decoded
using BinHex 4.0 or 5.0. The Stuffit utility also has a facility for decoding
BinHex files.

MacBinary: This is a binary file which is used by many Macintosh communications
programs when transfering files. You will probably need an xmodem file transfer
utility on your workstation to send the file.

TOPS: This file was moved using TOPS/sun (version 2.1)  for those who use TOPS 
to move files between Macs and Sun Workstations. The information in this
file is actually in a .rsrc subdirectory which was automatically
created by TOPS when the file was copied using the Mac Finder. This version
has been tested with Tops/Sun versions 2.1 (SunOS 3.x) and 2.2 (SunOS 4.x).

GatorBox: This version was transfered using a Cayman Systems Gatorbox running
GatorSoftware 1.4. Use this version if you have a GatorBox gateway and
AppleShare workstation software on your Macintosh.

                          ------------------------

To run the Frame EPSF converter, simply double click on it. A standard file
open dialog box will come up which displays the available EPSF documents.
Select one of these and click OK. A standard file save box will then appear 
allowing you to name the output file. Click OK if the default name is 
suitable. The file will then be converted. You should now transfer the output 
file to your workstation as a text file. You can now use FrameMaker's Import 
function to read in the file. The preview image will be displayed on the 
screen while the equivalent PostScript code will be sent to the printer.

Frame EPSF Converter works best with files created by Adobe Illustrator and
with files that use "pure ASCII" epsf and fully conform to Adobe's EPSF
formatting conventions. Some applications, particularly scanner programs,
create EPSF files which contain non-ASCII binary data. This will cause problems
if the printer is connected to a Unix host via a serial connection, as opposed
to an AppleTalk connection such as Tops Print. If the file does not conform to
the Adobe EPSF formatting conventions, Frame EPSF Converter may not be able to 
recognize key portions of the file and will thus fail with an error message.
