summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/epspdf
diff options
context:
space:
mode:
authorSiep Kroonenberg <siepo@cybercomm.nl>2008-07-27 20:42:58 +0000
committerSiep Kroonenberg <siepo@cybercomm.nl>2008-07-27 20:42:58 +0000
commit7aeaf5c135f604e1fe30c5c6ecc2b11b54f01e67 (patch)
treed0809312979e89f75133408004b760a661a90c19 /Master/texmf-dist/doc/epspdf
parent81d3bf31b8ea3a46c75779abba79692988607eda (diff)
epspdf: updated docs, minor tweaks
git-svn-id: svn://tug.org/texlive/trunk@9821 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/epspdf')
-rw-r--r--Master/texmf-dist/doc/epspdf/epspdf.install278
-rw-r--r--Master/texmf-dist/doc/epspdf/epspdf_UG.html38
-rw-r--r--Master/texmf-dist/doc/epspdf/index.html247
3 files changed, 337 insertions, 226 deletions
diff --git a/Master/texmf-dist/doc/epspdf/epspdf.install b/Master/texmf-dist/doc/epspdf/epspdf.install
index 759cebde26e..b05bc5d7d8e 100644
--- a/Master/texmf-dist/doc/epspdf/epspdf.install
+++ b/Master/texmf-dist/doc/epspdf/epspdf.install
@@ -14,10 +14,8 @@ Table of Contents
* [4]Installation
* [5]Preview programs
* [6]Files
- * [7]Supporting software
- * [8]Releases
- * [9]To do
- * [10]User Guide
+ * [7]Releases
+ * [8]User Guide
Features
@@ -31,6 +29,7 @@ Features
* GUI- and command-line version
* GUI-configurable preferences
* Multiplatform: works unchanged on Windows, Unix/Linux and Mac OS X
+ * Support for TeX Live
Epspdf has been created with TeX users in mind. For them, eps and pdf are
the preferred graphics formats.
@@ -54,68 +53,119 @@ Features
The command-line program epspdf is written in Ruby. Epspdftk, its GUI
companion, in Ruby/Tk.
+ Starting with the 2008 edition, epspdf is included in TeX Live as an
+ optional package, complete with wrapper scripts epspdf and epspdftk which
+ can be called from the command-line without further ado.
+
Prerequisites
- Windows with setup progrogam
+ These are the required and optional prerequisites:
- Download Ghostscript and GSview from the [11]Ghostscript site. Ghostscript
- and GSview each come with a standard Windows setup program.
+ * Ghostscript
+ * pdftops from the xpdf suite, strongly recommended for better pdf to
+ PostScript conversions
+ * Ruby 1.8.x
+ * Tcl/Tk is only required for the GUI interface. Only version 8.4 has
+ been tested.
+ * Optional: viewers for PostScript and pdf
- You can get pdftops as part of the xpdf suite from the [12]xpdf site.
- Download the zipfile with Windows binaries and unpack it in a location of
- your choice. The Configure screen of epspdftk lets you browse for this
- location. You only have to do this once. Xpdf itself is not in this zip
- file.
+ You may not have to install all of these yourself.
- The necessary Ruby components are already included in the setup program.
+ Linux
- Windows zipfile with separately installed Ruby
+ On a current Linux distribution you can almost certainly install
+ everything from your distribution's package repositories. You may have to
+ install Ruby's Tk bindings, in addition to Ruby and Tcl/Tk themselves. The
+ name of such a package might be e.g. libtcltk-ruby. As to PostScript- and
+ pdf viewers: epspdf tests for several popular viewers, but the
+ configuration screen also lets you specify viewers manually.
- For Ghostscript, GSview and the xpdf suite, see above.
+ Mac OS X (Tiger and later)
- You can get a [13]one-click Ruby installer from [14]Rubyforge. For Ruby
- version 1.8.4 and later you have to download and install Tcl/Tk
- separately, in the form of [15]ActiveTcl. If you are only interested in
- the command-line version then you can leave out ActiveTcl.
+ Ruby and Tcl/Tk are already part of the operating system. Ghostscript is
+ included in MacTeX, but is also available via e.g. MacPorts. You can get
+ pdftops from MacPorts as part of either Poppler or xpdf. Another source is
+ [9]http://users.phg-online.de/tk/MOSXS/.
- Unix/Linux
+ If you want to compile xpdf it yourself, which is not hard, you can ignore
+ warnings about X, Motif or FreeType not being found since these missing
+ libraries won't affect the compilation of pdftops.
- You need Ghostscript, preferably xpdf/pdftops, Ruby (version at least 1.8)
- and for GUI use also Ruby/Tk. These will almost certainly be available as
- packages from your distribution.
+ Windows (Windows 2000 and later)
- Mac OS X
+ If you use the TeXLive package (2008 or later):
+ Epspdf and epspdftk will use Ghostscript and pdftops built into
+ TeX Live. You still need to download and install Ruby and
+ optionally Tcl/Tk.
+
+ If you install from the setup program:
+ This package includes a subset of Ruby/Tk, but you have to provide
+ Ghostscript and pdftops yourself.
+
+ If you use the zipfile:
+ In this case, you have to provide everything yourself.
+
+ URLs for the prerequisites
+
+ Ghostscript and GSview ([10]http://pages.cs.wisc.edu/~ghost/)
+ Contains sources and Windows binaries. The Windows binaries come
+ with standard GUI Windows setup programs.
+
+ XPDF ([11]http://www.foolabs.com/xpdf/)
+ Sources and Windows binaries. The Windows binaries are packaged
+ into a zipfile, which has to be manually unpacked. The Configure
+ screen of epspdftk lets you browse for the chosen location. You
+ have to do this only once.
+
+ XPDF, Mac OS X binaries ([12]http://users.phg-online.de/tk/MOSXS/)
+ These are universal binaries.
+
+ TeX Live ([13]http://www.tug.org/texlive/)
+ TeX Live 2008 includes epspdf as an optional install. For Windows,
+ this version doesn't require external copies of pdftops or
+ Ghostscript.
- Ghostscript and xpdf are available via the [16]Fink Project, in the Text
- section.
+ MacTeX ([14]http://www.tug.org/mactex/)
+ MacTeX is based on TeX Live. Its set of add-ons includes
+ Ghostscript, and can be downloaded separately.
- If you don't (want to) use Fink, you can download and install Gerben
- Wierda's i-Installer from the [17]i-Installer Home Page and then use the
- i-Installer to download and install the Ghostscript i-package.
+ The MacPorts Project ([15]http://www.macports.org/)
+ MacTeX has Poppler- and xpdf packages either of which include
+ pdftops.
- There is a [18]package for the xpdf suite at
- [19]http://users.phg-online.de/tk/MOSXS/. Or you can compile it yourself.
- You can download the source from the [20]xpdf site. For compilation, you
- need to have XCode installed, but nothing else, I think, at least not
- under Tiger. You can safely omit the xpdf- and pdftoppm components if
- configure says that they will not be compiled because of missing
- libraries.
+ Ruby one-click installer fro Windows (
+ [16]http://rubyforge.org/projects/rubyinstaller/)
+ Current versions (1.8.4 and later) require Tcl/Tk to be separately
+ installed.
- Ruby 1.8.2 and Ruby/Tk are part of Mac OS X Tiger. X11 needs to be
- installed, although Ruby/Tk is not an X11 application. For earlier
- versions of Mac OS X, you are on your own.
+ Old releases of Ruby one-click installer (
+ [17]http://rubyforge.org/frs/?group_id=167)
+ Versions prior to 1.8.4 include Tcl/Tk.
+
+ Ruby source code ([18]http://www.ruby-lang.org/en/downloads/)
+ For those people who prefer to roll their own...
+
+ ActiveTcl from ActiveState (
+ [19]http://activestate.com/Products/ActiveTcl/
+ Get version 8.4, not 8.5.
Installation
- Windows with setup program
+ First make sure that the prerequisites are met. Then:
+
+ TeX Live 2008
+
+ Use TeX Live's package manager tlmgr for installation.
+
+ Windows setup program
- Download the [21]epspdftk setup program. You can run it in the usual way,
+ Download the [20]epspdftk setup program. You can run it in the usual way,
by double-clicking. The setup program will create entries in your start
menu for epspdftk and for the user manual.
Windows zipfile
- Download the [22]epspdf zip file, unpack it somewhere and create a
+ Download the [21]epspdf zip file, unpack it somewhere and create a
shortcut for epspdftk.rbw. If you plan to use the command-line version,
put a batchfile in a directory on your path with the line
@@ -125,10 +175,10 @@ Installation
Unix/Linux
- Download the [23]tar.gz archive and unpack it in some directory. All files
+ Download the [22]tar.gz archive and unpack it in some directory. All files
should be in the same directory; that is how they find each other. If you
- plan to use epspdf.rb from the command-line, then you may want to create a
- shell script epspdf such as
+ plan to use epspdf.rb from the command-line, then create a shell script
+ epspdf such as
#!/bin/sh
<path_to_epspdf>/epspdf.rb $*
@@ -144,7 +194,7 @@ Installation
directory.
You can try to start epspdftk.rb from the dock or by doubleclicking. If
- that doesn't work out, give the [24]epspdf.app applet a try. After
+ that doesn't work out, give the [23]epspdf.app applet a try. After
unpacking, move the file epspdf.app to the same directory as the .rb
files. The zipfile also includes this file in text format
(epspdf.applescript).
@@ -156,15 +206,17 @@ Preview programs
Windows
- Epspdftk will use the default Windows viewers for PostScript and pdf.
- Without GSview, you probably won't be able to view PostScript files.
+ Epspdftk will use the default Windows viewers for PostScript and pdf. If
+ you have TeX Live 2008 or later then you can assign <TeX Live
+ root>\bin\win32\psv.bat as previewer for .ps- and .eps files.
Unix/Linux
Supported PostScript viewers include evince, gv, ggv and kghostview. These
are also listed as pdf viewers. Additional pdf viewers are xpdf, gpdf and
- acroread/Adobe Reader. If you think that I omitted a PostScript- or pdf
- viewer, let me know and I'll probably add it in the next release.
+ acroread/Adobe Reader. You can also specify a previewer manually in the
+ configuration screen; see the user guide, under [24]"The configuration
+ screen"..
Mac OS X
@@ -172,36 +224,38 @@ Preview programs
Files
- * [25]epspdf.0.2.12.tgz preferred for Unix and Mac OS X
- * [26]epspdf.0.2.12.zip preferred for Windows
- * [27]epspdf.0.2.12.exe Windows setup program, including Ruby/Tk subset
+ * [25]epspdf.0.3.0.tgz preferred for Unix and Mac OS X
+ * [26]epspdf.0.3.0.zip preferred for Windows
+ * [27]epspdf.0.3.0.exe Windows setup program, including Ruby/Tk subset
* [28]epspdf_app.0.2.01.zip Mac OS X applet for starting epspdftk.rb
Older releases
- * [29]epspdf.0.2.11.tgz for Unix and Mac OS X
- * [30]epspdf.0.2.11.zip for Windows
- * [31]epspdf.0.2.11.exe Windows setup program
- * [32]epspdf.0.2.01.tgz for Unix and Mac OS X
- * [33]epspdf.0.2.01.zip for Windows
- * [34]epspdf.0.2.exe, Windows setup program
-
-Supporting software
-
- * [35]Ghostscript and GSview
- * [36]XPDF
- * [37]OS X binary for xpdf/pdftops
- * [38]Ruby one-click installer
- * [39]Ruby Home Page
- * [40]ActiveTcl
+ * [29]epspdf.0.2.12.tgz for Unix and Mac OS X
+ * [30]epspdf.0.2.12.zip for Windows
+ * [31]epspdf.0.2.12.exe Windows setup program
+ * [32]epspdf.0.2.11.tgz for Unix and Mac OS X
+ * [33]epspdf.0.2.11.zip for Windows
+ * [34]epspdf.0.2.11.exe Windows setup program
+ * [35]epspdf.0.2.01.tgz for Unix and Mac OS X
+ * [36]epspdf.0.2.01.zip for Windows
+ * [37]epspdf.0.2.exe, Windows setup program
Releases
+ 0.3.0
+ Current version. Under Windows, now recognizes whether it is
+ embedded in TeX Live 2008 and then uses ghostscript/pdftops from
+ TeX Live. Also added TeX Live wrapper scripts. Uninstaller for
+ Windows setup program. Bug fixes: now accepts non-numerical
+ version strings for pdftops. No longer checks for viewers under
+ Mac OS X.
+
0.2.12
- Current version. Bug fixes: log rotation now works. Under Windows,
- sometimes boundingboxes couldn't be calculated. This was caused by
- double quotes within backquotes. This is now avoided by using
- short filenames within backquotes. Minor changes in user guide.
+ Bug fixes: log rotation now works. Under Windows, sometimes
+ boundingboxes couldn't be calculated. This was caused by double
+ quotes within backquotes. This is now avoided by using short
+ filenames within backquotes. Minor changes in user guide.
0.2.11
Minor fixes. Changes in documentation.
@@ -220,24 +274,16 @@ Releases
Fixes to the Applescript applet epspdf.app for starting up
epspdftk under Mac OS X. It picks up the terminal search path and
no longer requires correct settings in
- $HOME/.MacOSX/environment.plist.
- Epspdf.app is now [41]packaged separately, under Mac OS X, and now
- has an intact resource fork. It has been removed from the other
- archives.
+ $HOME/.MacOSX/environment.plist. Epspdf.app is now packaged
+ separately, under Mac OS X, and now has an intact resource fork.
+ It has been removed from the other archives.
0.2
Original release
-To do
-
- * Artwork
- * GUI for some pdftops options
- * Proper help
- * Support for bitmapped formats (maybe)
-
--------------------------------------------------------------------------
- Last revised: November 20, 2006
+ Last revised: July 27, 2008
References
@@ -248,38 +294,34 @@ References
4. http://tex.aanhet.net/epspdf/index.html#install
5. http://tex.aanhet.net/epspdf/index.html#preview
6. http://tex.aanhet.net/epspdf/index.html#files
- 7. http://tex.aanhet.net/epspdf/index.html#supporting
- 8. http://tex.aanhet.net/epspdf/index.html#releases
- 9. http://tex.aanhet.net/epspdf/index.html#todo
- 10. http://tex.aanhet.net/epspdf/epspdf_UG.html
- 11. http://www.cs.wisc.edu/~ghost/
- 12. http://www.foolabs.com/xpdf/
- 13. http://rubyforge.org/projects/rubyinstaller/
- 14. http://rubyforge.org/
- 15. http://activestate.com/Products/ActiveTcl/
- 16. http://fink.sourceforge.net/
- 17. http://ii2.sourceforge.net/
- 18. http://users.phg-online.de/tk/MOSXS/xpdf-tools-3.dmg
- 19. http://users.phg-online.de/tk/MOSXS/
- 20. http://www.foolabs.com/xpdf/
- 21. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe
- 22. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip
- 23. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz
- 24. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip
- 25. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz
- 26. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip
- 27. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe
+ 7. http://tex.aanhet.net/epspdf/index.html#releases
+ 8. http://tex.aanhet.net/epspdf/epspdf_UG.html
+ 9. http://users.phg-online.de/tk/MOSXS/
+ 10. http://pages.cs.wisc.edu/~ghost/
+ 11. http://www.foolabs.com/xpdf/
+ 12. http://users.phg-online.de/tk/MOSXS/
+ 13. http://www.tug.org/texlive/
+ 14. http://www.tug.org/mactex/
+ 15. http://www.macports.org/
+ 16. http://rubyforge.org/projects/rubyinstaller/
+ 17. http://rubyforge.org/frs/?group_id=167
+ 18. http://www.ruby-lang.org/en/downloads/
+ 19. http://activestate.com/Products/ActiveTcl/
+ 20. http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe
+ 21. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip
+ 22. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz
+ 23. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip
+ 24. http://tex.aanhet.net/epspdf/epspdf_UG.html#configure
+ 25. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz
+ 26. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip
+ 27. http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe
28. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip
- 29. http://tex.aanhet.net/epspdf/epspdf.0.2.11.tgz
- 30. http://tex.aanhet.net/epspdf/epspdf.0.2.11.zip
- 31. http://tex.aanhet.net/epspdf/epspdf.0.2.11.exe
- 32. http://tex.aanhet.net/epspdf/epspdf.0.2.01.tgz
- 33. http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip
- 34. http://tex.aanhet.net/epspdf/epspdf.0.2.exe
- 35. http://www.cs.wisc.edu/~ghost/
- 36. http://www.foolabs.com/xpdf/
- 37. http://users.phg-online.de/tk/MOSXS/
- 38. http://rubyforge.org/projects/rubyinstaller/
- 39. http://ruby-lang.org/
- 40. http://activestate.com/Products/ActiveTcl/
- 41. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip
+ 29. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz
+ 30. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip
+ 31. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe
+ 32. http://tex.aanhet.net/epspdf/epspdf.0.2.11.tgz
+ 33. http://tex.aanhet.net/epspdf/epspdf.0.2.11.zip
+ 34. http://tex.aanhet.net/epspdf/epspdf.0.2.11.exe
+ 35. http://tex.aanhet.net/epspdf/epspdf.0.2.01.tgz
+ 36. http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip
+ 37. http://tex.aanhet.net/epspdf/epspdf.0.2.exe
diff --git a/Master/texmf-dist/doc/epspdf/epspdf_UG.html b/Master/texmf-dist/doc/epspdf/epspdf_UG.html
index 27a7d96626a..6ac2368788f 100644
--- a/Master/texmf-dist/doc/epspdf/epspdf_UG.html
+++ b/Master/texmf-dist/doc/epspdf/epspdf_UG.html
@@ -41,7 +41,8 @@ configurable; see below under <a href="#configure">The Configuration
screen.</a></p>
<p>The View button is grayed if epspdf thinks that there is no
-previewer for the current file.</p>
+previewer for the current file; see <a href="index.html#preview">the
+epspdf main page</a> for details.</p>
<p class="display"><img src="images/greenbroccoli.png" alt=""/></p>
@@ -120,6 +121,15 @@ represent eps files on screen without having to interpret the
PostScript code itself. Epspdf currently has no option to preserve
or add them.</p>
+<h2>On-the-fly conversion</h2>
+
+<p>Daniel Becker wrote a LaTeX package epspdfconversion which
+converts eps files on the fly to pdf, like Heiko Oberdiek's epstopdf
+package, but with epspdf as backend. It can make use of the epspdf
+conversion options. Both packages are available from <a
+href="http://www.tug.org/ctan.html">CTAN</a> and included in TeX
+Live.</p>
+
<h2>Exporting PostScript from Windows programs</h2>
<p>Often, the only way to get EPS or PostScript from a Windows
@@ -158,14 +168,24 @@ PostScript output option. Using the Archive output option instead
solved the problem. In general, experiment a bit in generating
your PostScript.</p>
+<h3>Mac OS X problems with epspdftk</h3>
+
+<p>Even though epspdftk is not an X11 program, you may still need
+some pieces of X11 and the X11 SDK, which are optional installs of
+OS X.</p>
+
+<p>Under Leopard, the window that is displayed during the conversion
+stays blank. I have no idea why.</p>
+
<h3>Resources for troubleshooting</h3>
-<p><i>Logfile.</i> Epspdf and epspdftk maintain a log file
-epspdf.log in your home directory or, in case of Windows, your
-profile directory. This profile directory may be c:\Documents and
-Settings\&lt;your user name>. Otherwise, open a DOS box and type
-'<tt>echo %USERPROFILE%</tt>', which will produce this
-information.</p>
+<p><i>Logfile.</i> Epspdf and epspdftk maintain a log file. For Unix
+and Mac OS X it is epspdf.log in your home directory. For Windows,
+it is epspdf.log or epspdftl.log in your profile directory. The
+latter filename is used if epspdf is embedded in TeX Live. This
+profile directory may be c:\Documents and Settings\&lt;your user
+name>. Otherwise, open a DOS box and type '<tt>echo
+%USERPROFILE%</tt>', which will produce this information.</p>
<p>This logfile lists all Ghostscript- and pdftops program
calls plus error information. 'EPCallError' is probably a program
@@ -175,11 +195,11 @@ may be a program error as well.</p>
<p><i>Temporary files.</i> The temporary files may give clues as
well. They will be deleted at the end of the session (for the
command-line version, give a -d parameter to keep the temporary
-files). Check the logfile which temporary files have been
+files). The logfile can tell you which temporary files have been
created.</p>
<h3><a href="index.html">Main page...</a></h3>
<hr/>
-<p class="fineprint">Last revised: Noverber 20, 2006</p>
+<p class="fineprint">Last revised: July 27, 2008</p>
</body></html>
diff --git a/Master/texmf-dist/doc/epspdf/index.html b/Master/texmf-dist/doc/epspdf/index.html
index 476deff50c9..a247c60bb07 100644
--- a/Master/texmf-dist/doc/epspdf/index.html
+++ b/Master/texmf-dist/doc/epspdf/index.html
@@ -31,9 +31,7 @@ this page</a></p>
<li><a href="#install">Installation</a></li>
<li><a href="#preview">Preview programs</a></li>
<li><a href="#files">Files</a></li>
-<li><a href="#supporting">Supporting software</a></li>
<li><a href="#releases">Releases</a></li>
-<li><a href="#todo">To do</a></li>
<li><a href="epspdf_UG.html">User Guide</a></li>
</ul>
@@ -49,7 +47,9 @@ this page</a></p>
<li>Grayscaling (sometimes)</li>
<li>GUI- and command-line version</li>
<li>GUI-configurable preferences</li>
-<li>Multiplatform: works unchanged on Windows, Unix/Linux and Mac OS X</li>
+<li>Multiplatform: works unchanged on Windows, Unix/Linux and Mac OS
+X</li>
+<li>Support for TeX Live</li>
</ul>
<p>Epspdf has been created with TeX users in mind. For them, eps and
@@ -75,85 +75,144 @@ does whatever back-and-forth conversions are necessary.</p>
<p>The command-line program epspdf is written in Ruby. Epspdftk,
its GUI companion, in Ruby/Tk.</p>
+<p>Starting with the 2008 edition, epspdf is included in TeX Live as
+an optional package, complete with wrapper scripts epspdf and
+epspdftk which can be called from the command-line without further
+ado.</p>
+
<h2><a name="prerequisites"/>Prerequisites</h2>
-<h3>Windows with setup progrogam</h3>
+<p>These are the required and optional prerequisites:</p>
+<ul>
+<li>Ghostscript</li>
+<li>pdftops from the xpdf suite, strongly recommended for better
+ pdf to PostScript conversions</li>
+<li>Ruby 1.8.<i>x</i></li>
+<li>Tcl/Tk is only required for the GUI interface. Only version 8.4
+ has been tested.</li>
+<li>Optional: viewers for PostScript and pdf</li>
+</ul>
-<p>Download Ghostscript and GSview from the <a
-href="http://www.cs.wisc.edu/~ghost/">Ghostscript site.</a>
-Ghostscript and GSview each come with a standard Windows setup
-program.</p>
+<p>You may not have to install all of these yourself.</p>
-<p>You can get pdftops as part of the xpdf suite from the <a
-href="http://www.foolabs.com/xpdf/">xpdf site.</a> Download the
-zipfile with Windows binaries and unpack it in a location of your
-choice. The Configure screen of epspdftk lets you browse for this
-location. You only have to do this once. Xpdf itself is not in this
-zip file.</p>
+<h3>Linux</h3>
-<p>The necessary Ruby components are already included in the setup
-program.</p>
+<p>On a current Linux distribution you can almost certainly install
+everything from your distribution's package repositories. You may
+have to install Ruby's Tk bindings, in addition to Ruby and Tcl/Tk
+themselves. The name of such a package might be
+e.g. libtcltk-ruby. As to PostScript- and pdf viewers: epspdf tests
+for several popular viewers, but the configuration screen also lets
+you specify viewers manually.</p>
-<h3>Windows zipfile with separately installed Ruby</h3>
+<h3>Mac OS X (Tiger and later)</h3>
-<p>For Ghostscript, GSview and the xpdf suite, see above.</p>
+<p>Ruby and Tcl/Tk are already part of the operating
+system. Ghostscript is included in MacTeX, but is also available via
+e.g. MacPorts. You can get pdftops from MacPorts as part of either
+Poppler or xpdf. Another source is <a
+href="http://users.phg-online.de/tk/MOSXS/">http://users.phg-online.de/tk/MOSXS/</a>.</p>
-<p>You can get a <a
-href="http://rubyforge.org/projects/rubyinstaller/">one-click Ruby
-installer</a> from <a href="http://rubyforge.org/">Rubyforge.</a>
-For Ruby version 1.8.4 and later you have to download and install
-Tcl/Tk separately, in the form of <a
-href="http://activestate.com/Products/ActiveTcl/">ActiveTcl.</a> If
-you are only interested in the command-line version then you can
-leave out ActiveTcl.</p>
+<p>If you want to compile xpdf it yourself, which is not hard, you
+can ignore warnings about X, Motif or FreeType not being found since
+these missing libraries won't affect the compilation of pdftops.</p>
-<h3>Unix/Linux</h3>
+<h3>Windows (Windows 2000 and later)</h3>
-<p>You need Ghostscript, preferably xpdf/pdftops, Ruby (version at
-least 1.8) and for GUI use also Ruby/Tk. These will almost certainly
-be available as packages from your distribution.</p>
+<dl>
-<h3>Mac OS X</h3>
+<dt>If you use the TeXLive package (2008 or later):</dt> <dd>Epspdf
+and epspdftk will use Ghostscript and pdftops built into TeX
+Live. You still need to download and install Ruby and optionally
+Tcl/Tk.</dd>
+
+<dt>If you install from the setup program:</dt> <dd>This package
+includes a subset of Ruby/Tk, but you have to provide Ghostscript
+and pdftops yourself.</dd>
+
+<dt>If you use the zipfile:</dt> <dd>In this case, you have to
+provide everything yourself.</dd>
+
+</dl>
+
+
+<h3>URLs for the prerequisites</h3>
+
+<dl>
+
+<dt>Ghostscript and GSview (<a
+ href="http://pages.cs.wisc.edu/~ghost/">http://pages.cs.wisc.edu/~ghost/</a>)</dt>
+ <dd>Contains sources and Windows binaries. The Windows binaries
+ come with standard GUI Windows setup programs.</dd>
+
+<dt>XPDF (<a
+ href="http://www.foolabs.com/xpdf/">http://www.foolabs.com/xpdf/</a>)</dt>
+ <dd> Sources and Windows binaries. The Windows binaries are
+ packaged into a zipfile, which has to be manually unpacked. The
+ Configure screen of epspdftk lets you browse for the chosen
+ location. You have to do this only once. </dd>
+
+<dt>XPDF, Mac OS X binaries (<a
+ href="http://users.phg-online.de/tk/MOSXS/">http://users.phg-online.de/tk/MOSXS/</a>)</dt>
+ <dd>These are universal binaries.</dd>
+
+<dt>TeX Live (<a
+ href="http://www.tug.org/texlive/">http://www.tug.org/texlive/</a>)</dt>
+ <dd>TeX Live 2008 includes epspdf as an optional install. For
+ Windows, this version doesn't require external copies of pdftops
+ or Ghostscript.</dd>
+
+<dt>MacTeX (<a
+ href="http://www.tug.org/mactex/">http://www.tug.org/mactex/</a>)</dt>
+ <dd>MacTeX is based on TeX Live. Its set of add-ons includes
+ Ghostscript, and can be downloaded separately.</dd>
+
+<dt>The MacPorts Project (<a
+ href="http://www.macports.org/">http://www.macports.org/</a>)</dt>
+ <dd>MacTeX has Poppler- and xpdf packages either of which include
+ pdftops.</dd>
+
+<dt>Ruby one-click installer fro Windows (<a
+ href="http://rubyforge.org/projects/rubyinstaller/">
+ http://rubyforge.org/projects/rubyinstaller/</a>)</dt> <dd>Current
+ versions (1.8.4 and later) require Tcl/Tk to be separately
+ installed.</dd>
+
+<dt>Old releases of Ruby one-click installer (<a
+ href="http://rubyforge.org/frs/?group_id=167">
+ http://rubyforge.org/frs/?group_id=167</a>)</dt> <dd>Versions
+ prior to 1.8.4 include Tcl/Tk.</dd>
+
+<dt>Ruby source code (<a
+ href="http://www.ruby-lang.org/en/downloads/">http://www.ruby-lang.org/en/downloads/</a>)</dt><dd>For
+ those people who prefer to roll their own...</dd>
+
+<dt>ActiveTcl from ActiveState (<a
+ href="http://activestate.com/Products/ActiveTcl/">
+ http://activestate.com/Products/ActiveTcl/</a></dt> <dd> Get
+ version 8.4, not 8.5.</dd>
+
+</dl>
-<p>Ghostscript and xpdf are available via the <a
-href="http://fink.sourceforge.net/">Fink Project</a>, in the Text
-section.</p>
-
-<p>If you don't (want to) use Fink, you can download and
-install Gerben Wierda's i-Installer from the <a
-href="http://ii2.sourceforge.net/">i-Installer Home Page</a> and
-then use the i-Installer to download and install the Ghostscript
-i-package.</p>
-
-<p>There is
-a <a
-href="http://users.phg-online.de/tk/MOSXS/xpdf-tools-3.dmg">package</a>
-for the xpdf suite
-at <a
-href="http://users.phg-online.de/tk/MOSXS/">http://users.phg-online.de/tk/MOSXS/.</a>
-Or you can compile it yourself. You can download the source from
-the <a href="http://www.foolabs.com/xpdf/">xpdf site</a>. For
-compilation, you need to have XCode installed, but nothing else, I
-think, at least not under Tiger. You can safely omit the xpdf- and
-pdftoppm components if configure says that they will not be compiled
-because of missing libraries.</p>
-
-<p>Ruby 1.8.2 and Ruby/Tk are part of Mac OS X Tiger. X11 needs to
-be installed, although Ruby/Tk is <i>not</i> an X11 application. For
-earlier versions of Mac OS X, you are on your own.</p>
<h2><a name="install"/>Installation</h2>
-<h3>Windows with setup program</h3>
+<p>First make sure that the prerequisites are met. Then:</p>
+
+<h3>TeX Live 2008</h3>
-<p>Download the <a href="epspdf.0.2.12.exe">epspdftk setup
+<p>Use TeX Live's package manager tlmgr for installation.</p>
+
+<h3>Windows setup program</h3>
+
+<p>Download the <a href="epspdf.0.3.0.exe">epspdftk setup
program.</a> You can run it in the usual way, by double-clicking. The
setup program will create entries in your start menu for epspdftk
and for the user manual.</p>
<h3>Windows zipfile</h3>
-<p>Download the <a href="epspdf.0.2.12.zip">epspdf zip file</a>,
+<p>Download the <a href="epspdf.0.3.0.zip">epspdf zip file</a>,
unpack it somewhere and create a shortcut for epspdftk.rbw. If you
plan to use the command-line version, put a batchfile in a directory
on your path with the line</p>
@@ -166,11 +225,11 @@ on your path with the line</p>
<h3>Unix/Linux</h3>
-<p>Download the <a href="epspdf.0.2.12.tgz">tar.gz archive</a> and
+<p>Download the <a href="epspdf.0.3.0.tgz">tar.gz archive</a> and
unpack it in some directory. All files should be in the same
directory; that is how they find each other. If you plan to use
-epspdf.rb from the command-line, then you may want to create a shell
-script <tt>epspdf</tt> such as</p>
+epspdf.rb from the command-line, then create a shell script
+<tt>epspdf</tt> such as</p>
<pre>
#!/bin/sh
@@ -204,16 +263,18 @@ problem files.</p>
<h3>Windows</h3>
<p>Epspdftk will use the default Windows viewers for PostScript and
-pdf. Without GSview, you probably won't be able to view PostScript
+pdf. If you have TeX Live 2008 or later then you can assign &lt;TeX
+Live root>\bin\win32\psv.bat as previewer for .ps- and .eps
files.</p>
<h3>Unix/Linux</h3>
<p>Supported PostScript viewers include evince, gv, ggv and
kghostview. These are also listed as pdf viewers. Additional pdf
-viewers are xpdf, gpdf and acroread/Adobe Reader. If you think that
-I omitted a PostScript- or pdf viewer, let me know and I'll probably
-add it in the next release.</p>
+viewers are xpdf, gpdf and acroread/Adobe Reader. You can also
+specify a previewer manually in the configuration screen; see the
+user guide, under <a href="epspdf_UG.html#configure">"The
+configuration screen".</a>.</p>
<h3>Mac OS X</h3>
@@ -222,13 +283,13 @@ add it in the next release.</p>
<h2><a name="files"/>Files</h2>
<ul>
-<li><a href="epspdf.0.2.12.tgz">epspdf.0.2.12.tgz</a> preferred for Unix
+<li><a href="epspdf.0.3.0.tgz">epspdf.0.3.0.tgz</a> preferred for Unix
and Mac OS X</li>
-<li><a href="epspdf.0.2.12.zip">epspdf.0.2.12.zip</a> preferred for
+<li><a href="epspdf.0.3.0.zip">epspdf.0.3.0.zip</a> preferred for
Windows</li>
-<li><a href="epspdf.0.2.12.exe">epspdf.0.2.12.exe</a> Windows setup
+<li><a href="epspdf.0.3.0.exe">epspdf.0.3.0.exe</a> Windows setup
program, including Ruby/Tk subset</li>
<li><a href="epspdf_app.0.2.01.zip">epspdf_app.0.2.01.zip</a> Mac OS X
@@ -237,6 +298,12 @@ applet for starting epspdftk.rb</li>
<h3>Older releases</h3>
<ul>
+<li><a href="epspdf.0.2.12.tgz">epspdf.0.2.12.tgz</a> for Unix
+and Mac OS X</li>
+<li><a href="epspdf.0.2.12.zip">epspdf.0.2.12.zip</a> for
+Windows</li>
+<li><a href="epspdf.0.2.12.exe">epspdf.0.2.12.exe</a> Windows setup
+ program</li>
<li><a href="epspdf.0.2.11.tgz">epspdf.0.2.11.tgz</a> for Unix
and Mac OS X</li>
<li><a href="epspdf.0.2.11.zip">epspdf.0.2.11.zip</a> for
@@ -251,25 +318,16 @@ Windows</li>
program</li>
</ul>
-<h2><a name="supporting"/>Supporting software</h2>
-
-<ul>
-<li><a href="http://www.cs.wisc.edu/~ghost/">Ghostscript and
- GSview</a></li>
-<li><a href="http://www.foolabs.com/xpdf/">XPDF</a></li>
-<li><a href="http://users.phg-online.de/tk/MOSXS/">OS X
- binary for xpdf/pdftops</a></li>
-<li><a href="http://rubyforge.org/projects/rubyinstaller/">Ruby one-click
- installer</a></li>
-<li><a href="http://ruby-lang.org/">Ruby Home Page</a></li>
-<li><a
-href="http://activestate.com/Products/ActiveTcl/">ActiveTcl</a></li>
-</ul>
-
<h2><a name="releases"/>Releases</h2>
-<dl>
-<dt>0.2.12</dt><dd>Current version. Bug fixes: log rotation now
+<dl> <dt>0.3.0</dt><dd>Current version. Under Windows, now
+recognizes whether it is embedded in TeX Live 2008 and then uses
+ghostscript/pdftops from TeX Live. Also added TeX Live wrapper
+scripts. Uninstaller for Windows setup program. Bug fixes: now
+accepts non-numerical version strings for pdftops. No longer checks
+for viewers under Mac OS X.</dd>
+
+<dt>0.2.12</dt><dd>Bug fixes: log rotation now
works. Under Windows, sometimes boundingboxes couldn't be
calculated. This was caused by double quotes within backquotes. This
is now avoided by using short filenames within backquotes. Minor
@@ -289,24 +347,15 @@ sessions).</dd><dd>Changes in documentation.</dd>
<dt>0.2.01</dt><dd>Fixes to the Applescript applet epspdf.app for
starting up epspdftk under Mac OS X. It picks up the terminal search
path and no longer requires correct settings in
-$HOME/.MacOSX/environment.plist.</dd><dd>Epspdf.app is now <a
-href="epspdf_app.0.2.01.zip">packaged separately</a>, under Mac OS
+$HOME/.MacOSX/environment.plist. Epspdf.app is now
+packaged separately, under Mac OS
X, and now has an intact resource fork. It has been removed from the
other archives.</dd>
<dt>0.2</dt><dd>Original release</dd>
</dl>
-<h2><a name="todo"/>To do</h2>
-
-<ul>
-<li>Artwork</li>
-<li>GUI for some pdftops options</li>
-<li>Proper help</li>
-<li>Support for bitmapped formats (maybe)</li>
-</ul>
-
<hr/>
-<p class="fineprint">Last revised: November 20, 2006</p>
+<p class="fineprint">Last revised: July 27, 2008</p>
</body></html>