psfig/tex 1.4 -- TeX macros for the inclusion of postscript figures

==================================================================
==================================================================
All software, documentation, and related files in this distribution of
psfig/tex are Copyright (c) 1987,1990 Trevor J. Darrell

Permission is granted for use and non-profit distribution of psfig/tex 
providing that this notice be clearly maintained, but the right to
distribute any portion of psfig/tex for profit or as part of any commercial
product is specifically reserved for the author.
=====

Psfig/tex uses \special calls to manipulate the PostScript environment
within a document and include figure files. Version 1.4 of psfig/tex
works with the "dvips" PostScript driver, which is available from
labrea.stanford.edu.

Additionally, it might work with the driver also called "dvips"
sold by ArborText, and with the version of "dvi2ps" written by
Tony Li <tli@sargas.usc.edy> (use old/psfig-li.tex).

====
Installation

No special installation is needed with the dvips driver.
Simply copy the psfig.tex file into a directory on your
TeX include path (e.g. /usr/lib/tex/macros).

A copy of the users guide can be printed by running latex and
dvips on psfig-doc.tex


=====================================================================
=====================================================================
Tips on including Macintosh figures:
====================================

1) How to capture a figure and the LaserPrep prolog into a disk file:

Many different methods exist to appempt to do this, some of which As
of this writing, it is possible to convince MacDraw to place a Postscript
description of a figure in a file rather than sending it directly to a
LaserWriter by hitting clover-F immediately after clicking
`OK' on the print dialog box. The file is always called `PostScript'
and is left in the folder MacDraw was started in. Use a communications
program to move the file over to the host on which TeX is running.

MacDraw creates a output file in the form of `QuickDraw' calls, which
are interpreted as a set of PostScript procedures. These procedures
are defined in what we call the Macintosh LaserPrep prolog, which must
be downloaded before Macintosh figures are sent to the printer. By
using clover-K rather than clover-F in the key sequence above both the
prolog and figure will be captured in the PostScript file.  The prolog
can be extracted by hand-editing out the portion of the clover-K file
also present in the clover-F file.  

2) Make the postscript suitible for including as an encapsulated
postscript figure.

Unfortunately, the postscript produced by most versions of the
LaserWriter driver is not well suited to be included directly as a
psfig figure.  Most versions of the LaserPrep do not include an
accurate bounding box comment in the PostScript files they produce;
figures created by these systems will have to have their bounding box
added by hand. "graphpaper.ps" is often useful for determining the
bounding box of a figure. The "cleanfig" shell script adds a default
bounding box, removes nasty "%%EOF" lines, converts CF-LF (useful for
files that have been moved across appletalk), and strips away
downloaded fonts.

NOTE: fonts are stripped by the cleanfig program because I found that
my documents were crashing on figures that were downloading fonts that
were already printer-resident. Cleanfig will remove all fonts, so if
you are using non-resident fonts in your figures you will have to
modify cleanfig to not stip out the downloading of those fonts.

The laserprep prolog often needs to have certain offending
code sanitized in order for mac figures to be used
as encapsulated postscript. Many figures will work with
unmodified laserpreps, but some wont. The file "lprep68.pro"
has a sanitized laserprep version 68, and "lprep68.fix" some 
ps code that attempts to sanitize a laserprep that is already
downloaded. Use at your own risk.

You can explicity download your own laserprep in front of
a document either by prepending it using /bin/cat, or with
the dvips command \special{header=lprep68.pro}

"macdemo.tex" containts a test document that including four version 68
mac figures; "doc.ps.tjd" has what I get after running latex and dvips.

======================================================================