Description:

* PsFrag is a set of LaTeX macros for overlaying postscript figures with
  fragments of LaTeX.  More precisely, the PsFrag macros allow specific
  pieces of postscript text in a postscript figure (included via \epsfbox
  or \special) to be replaced with arbitrary fragments of LaTeX.  When
  your document is latex'ed and dvips'ed, each piece of postscript text
  is replaced by the LaTeX text.
  
  The postscript file might be produced, for example, by xfig, idraw,
  matlab, xmath, etc.  Each string displayed by postscript's show operator
  is a candidate for replacement by LaTeX text, math symbols, equations,
  pictures etc.  For example, you can include a matlab plot in a LaTeX
  document with the title, axis labels, and legend generated by LaTeX.

  The LaTeX fragments can be optionally rotated, scaled, and repositioned
  relative to the text being replaced.  The LaTeX fragments automatically
  track the postscript text position as the scaling and offsets of the
  \special or \epsfbox are changed.

* PsFrag consists of four files:

  - epsf.sty: a slightly modified version of the original epsf.tex that
    supports PsFrag.  It's upward compatible with the old version, so
    it should work just the same when used without PsFrag.

  - psfrag.sty: contains the psfrag macros.

  - ps2psfrag: a shell script that uses ghostscript to find out the position,
    orientation and content of each piece of text that a particular postscript
    file displays (shows).  This has to be run once for each postscript
    figure.

  - ps2psfrag.ps: a postscript file used by ps2psfrag.

* PsFrag is available via anonymous ftp from isl.stanford.edu.  After
  logging in, cd to the directory pub/boyd/psfrag, and set binary mode.
  Get the compressed tar file psfrag.tar.Z, uncompress it, and tar xvf it:

	uncompress psfrag.tar.Z
	tar xvf psfrag.tar

  See the files README, USAGE, INSTALL for detailed information.

* Note: PsFrag uses ghostscript (gs) and assumes that your dvi to ps
  driver is Tomas Rokicki's dvips.  Nothing will work if you don't have
  these programs.

Craig Barratt, Sun Feb 29 23:29:05 PST 1992
craig@isl.stanford.edu
