summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/psfrag/announce.txt
blob: 6263b05fc125fe8550a1fecbc76d6afa99ced22f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
A brand-spankin' new version of PSfrag, version 3.04, for LaTeX2e can be
found at CTAN sites in the directory

macros/latex/contrib/supported/psfrag.

PSfrag 3.04 fixes some bugs discovered in PSfrag 3.03.

What is PSfrag?
---------------

Many drawing and graphing packages produce output in the Encapsulated
PostScript (EPS) format, but few can easily produce the equations and
other scientific text of which LaTeX is capable. On the other hand, many
LaTeX-based drawing packages are not as expressive or easy-to-use as the
many advanced drawing packages that produce EPS output.

PSfrag provides the best of both worlds by allowing the user to
precisely overlay Encapsulated PostScript (EPS) files with arbitrary
LaTeX constructions. In order to accomplish this, the user places a
simple text ``tag'' in the graphics file, as a ``position marker'' of
sorts. Then, using simple LaTeX commands, the user instructs PSfrag to
remove that tag from the figure, and replace it with a properly sized,
aligned, and rotated LaTeX equation.

The full documentation for PSfrag found in the release contains examples
and usage instructions.

To use PSfrag...
----------------

...you will need:

* LaTeX2e and the "graphics" package. (You can use the old epsf.sty
  macros with PSfrag, but you still need the graphics package.) Please
  make sure to get the newest versions of these packages from CTAN
  before submitting bug reports.
  
* If you plan to use PSfrag with the Seminar package, make sure you
  get the 10/97 release of this package.

* Any DVI-to-PostScript program that is well-supported by the "graphics"
  package. This author uses Tom Rokicki's "dvips"; I recommend it.
  PSfrag has also been verified for DVIPSone from Y&Y (using Level 2
  PostScript printers). 

Bugs? What Bugs?
----------------

PSfrag 3.04 is bug-free. Of course, we're kidding. That's what we said
about PSfrag 3.0, in fact, and look where it got us.

If you have problems, bug reports, or improvement suggestions, please
send them to the PSfrag maintainer's mailing list,

psfrag@rascals.stanford.edu

Please supply an example .tex file and .eps figure to demonstrate the
behavior you wish to have corrected or improved.

This is a majordomo mailing list; feel free to join if you would like to
actively participate in PSfrag development.

Thanks for using PSfrag!