summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-09-07 22:51:06 +0000
committerKarl Berry <karl@freefriends.org>2006-09-07 22:51:06 +0000
commitb7d59cb22d16fdd1e597b9c568ca8c39fcdcbe9e (patch)
tree85faf0cea6c855662f5bfebfdb6ea93cb913c17e /Master/texmf-dist/doc
parent7574e15dafe7af1cf8a2681d9b4cc9833887e69a (diff)
psfrag file update
git-svn-id: svn://tug.org/texlive/trunk@2095 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/psfrag/00readme.txt82
l---------Master/texmf-dist/doc/latex/psfrag/README1
-rw-r--r--Master/texmf-dist/doc/latex/psfrag/announce.txt63
-rw-r--r--Master/texmf-dist/doc/latex/psfrag/pfgguide.dvibin41752 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/latex/psfrag/pfgguide.pdfbin0 -> 69428 bytes
-rw-r--r--Master/texmf-dist/doc/latex/psfrag/pfgguide.ps.gzbin81865 -> 0 bytes
6 files changed, 146 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/psfrag/00readme.txt b/Master/texmf-dist/doc/latex/psfrag/00readme.txt
new file mode 100644
index 00000000000..948a8c46fc7
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/psfrag/00readme.txt
@@ -0,0 +1,82 @@
+This is the 00readme.txt file to accompany PSfrag, a system for LaTeX to
+integrate LaTeX equations with Encapsulated PostScript figures.
+
+These files compose the April 11, 1998 release of PSfrag 3.04. This is a
+maintenance release, and fixes some bugs and shortcomings in version 3.03. If
+you decide to install this release, you should not need to re-compile any of
+your files, unless you happened to encounter one of the bugs in an earlier
+version.
+
++-------------------------------+
+|QUICK INSTALLATION INSTRUCTIONS|
++-------------------------------+
+
+1. Run LaTeX on psfrag.ins, generating the package file psfrag.sty and
+ the PostScript header file psfrag.pro.
+2. Place psfrag.sty anywhere in your TeX search path; for kpathsea-based
+ systems such as teTeX, this is determined by the TEXINPUTS variable.
+3. Place psfrag.pro where your DVI-to-PostScript driver (e.g., dvips)
+ can find it. For kpathsea-based systems such as teTeX, this is
+ determined by the DVIPSHEADERS variable. For dvips in particular,
+ this includes the directory containing tex.pro and special.pro.
+
+More complete instructions are found in pfgguide.{tex,ps}. The files
+example.eps and testfig.eps are needed to typeset the documentation, so
+do not delete them if you want to re-generate pfgguide.ps. In fact, a
+good test to see if your TeX/LaTeX/PSfrag installation is working
+properly is to rename pfgguide.ps, generate a new pfgguide.ps from the
+.tex file, and compare the two files.
+
++------------------------------------+
+|IMPORTANT NOTES FOR PSFRAG 2.X USERS|
++------------------------------------+
+
+Note that PSfrag 3.x is quite a bit different from previous versions.
+The interface has been preserved, but the most notable difference is
+the absence of the preprocessing script ps2frag. That's right: _you
+will no longer need to run the ps2frag script_. This is a relief, of
+course, to users who could never get Perl working on their OS.
+
+However, PLEASE HEED the following differences between PSfrag 2.x and
+PSfrag 3.x! You will be soundly flogged with wet noodles if you ask
+about these and you haven't read this warning or the ones in pfgguide:
+1) PSfrag replacements no longer show up in their proper positions when
+ viewing the file with Xdvi. Instead, they show up in a vertical list
+ along the left side of the figure. So, you can check if they are
+ typeset properly in Xdvi, but you can't make sure they are properly
+ placed. To do that, you should use a PostScript previewer like
+ GhostView and GhostScript. This is an unforunate but necessary
+ consequence of the elimination of the preprocessing step.
+2) If you use the \tex command, note that it has been _deprecated_.
+ Now, you have to explicitly turn it on, either for the entire
+ LaTeX document or for each file individually. pfgguide.{tex,ps}
+ describe how to do this in detail. The reasons for this once
+ again turn to the elimination of the preprocessing step.
+I think that the elimination of the ps2frag script far outweighs
+either of these two (possible) disadvantages.
+
++---------------+
+| RELEASE NOTES |
++---------------+
+
+This is a bug-fix release, which fixes the following bugs encountered
+in PSfrag 3.03:
+
+1. Attempting to use EPS figures as PSfrag replacements would cause
+ an infinite loop. This should work properly now.
+2. Since the last release, the DVI-to-PS driver DVIPSone changed in
+ a way that made PSfrag replacements appear upside down.
+3. Small improvements to the psfrag.pro file have been made, which
+ will hopefully allow you to make EPS files out of PSfrag-ged
+ figures. I can't make any guarantees about this yet.
+4. The manual has been improved slightly; the known issues for
+ XFig and Seminar are now discussed. In addition, a more complete
+ discussion about ``valid'' tags is included.
+
+Bug reports and suggestions should go to psfrag@rascals.stanford.edu,
+the PSfrag maintainer's email-list. However, before submitting a bug
+report, please make sure that it is not already covered in the "Known
+issues" section of pfgguide.tex!
+
+Michael C. Grant
+
diff --git a/Master/texmf-dist/doc/latex/psfrag/README b/Master/texmf-dist/doc/latex/psfrag/README
new file mode 120000
index 00000000000..5d840374508
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/psfrag/README
@@ -0,0 +1 @@
+00readme.txt \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/psfrag/announce.txt b/Master/texmf-dist/doc/latex/psfrag/announce.txt
new file mode 100644
index 00000000000..6263b05fc12
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/psfrag/announce.txt
@@ -0,0 +1,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!
diff --git a/Master/texmf-dist/doc/latex/psfrag/pfgguide.dvi b/Master/texmf-dist/doc/latex/psfrag/pfgguide.dvi
deleted file mode 100644
index 4ee1f62606b..00000000000
--- a/Master/texmf-dist/doc/latex/psfrag/pfgguide.dvi
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/psfrag/pfgguide.pdf b/Master/texmf-dist/doc/latex/psfrag/pfgguide.pdf
new file mode 100644
index 00000000000..3e7a895a9f0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/psfrag/pfgguide.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/psfrag/pfgguide.ps.gz b/Master/texmf-dist/doc/latex/psfrag/pfgguide.ps.gz
deleted file mode 100644
index 53a0c851248..00000000000
--- a/Master/texmf-dist/doc/latex/psfrag/pfgguide.ps.gz
+++ /dev/null
Binary files differ