summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/epspdf
diff options
context:
space:
mode:
authorSiep Kroonenberg <siepo@cybercomm.nl>2010-03-29 10:43:59 +0000
committerSiep Kroonenberg <siepo@cybercomm.nl>2010-03-29 10:43:59 +0000
commite2f24386f207b8ca102a8a3535dd91ed99d7a7e1 (patch)
treecacea5e2f05f62cfa127c7e55852fcf7b0bb6611 /Master/texmf-dist/doc/support/epspdf
parent94f4030050e1d0cbad1ee1f93076439592593b93 (diff)
Epspdf rev. 0.5, documentation
git-svn-id: svn://tug.org/texlive/trunk@17605 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support/epspdf')
-rw-r--r--Master/texmf-dist/doc/support/epspdf/Changelog17
-rw-r--r--Master/texmf-dist/doc/support/epspdf/README16
-rw-r--r--Master/texmf-dist/doc/support/epspdf/README.tl5
-rw-r--r--Master/texmf-dist/doc/support/epspdf/default.css20
-rw-r--r--Master/texmf-dist/doc/support/epspdf/epspdf.install320
-rw-r--r--Master/texmf-dist/doc/support/epspdf/epspdf.pdfbin251976 -> 261092 bytes
-rw-r--r--Master/texmf-dist/doc/support/epspdf/epspdf.texi192
-rw-r--r--Master/texmf-dist/doc/support/epspdf/images/cnv_osx.pngbin32216 -> 42762 bytes
-rw-r--r--Master/texmf-dist/doc/support/epspdf/images/config_lnx.pngbin14765 -> 6671 bytes
-rw-r--r--Master/texmf-dist/doc/support/epspdf/images/epspdf.pngbin0 -> 4126 bytes
-rw-r--r--Master/texmf-dist/doc/support/epspdf/images/logo.pdfbin0 -> 4090 bytes
-rw-r--r--Master/texmf-dist/doc/support/epspdf/images/main_w32.pngbin7274 -> 10094 bytes
-rw-r--r--Master/texmf-dist/doc/support/epspdf/index.html210
13 files changed, 414 insertions, 366 deletions
diff --git a/Master/texmf-dist/doc/support/epspdf/Changelog b/Master/texmf-dist/doc/support/epspdf/Changelog
index c9ba0f85def..a178887f098 100644
--- a/Master/texmf-dist/doc/support/epspdf/Changelog
+++ b/Master/texmf-dist/doc/support/epspdf/Changelog
@@ -1,3 +1,20 @@
+2010-02-28 0.5
+
+ GUI module replaced with separate Tcl/Tk frontend. To this end,
+ epspdf.rb now has options for reading/writing settings over
+ stdin/stdout.
+
+ Epspdf.rb now also aborts on Unix if Ghostscript is missing.
+
+ Both logs and config moved to subdirectory: %APPDATA%/epspdf
+ under Windows, $HOME/.epspdf otherwise. On-demand log window.
+
+ Logo/icon added
+
+ Documentation updates
+
+ Manual in info format is now part of the distribution
+
2009-09-11 0.4.3
Patch for Ruby 1.9 compatibility (Ruben Stein). Patch for
diff --git a/Master/texmf-dist/doc/support/epspdf/README b/Master/texmf-dist/doc/support/epspdf/README
index 6dbbdc82130..07f17464f3e 100644
--- a/Master/texmf-dist/doc/support/epspdf/README
+++ b/Master/texmf-dist/doc/support/epspdf/README
@@ -3,15 +3,17 @@ command-line and as a GUI application.
Full documentation is available in the doc subdirectory.
-Windows users: you may prefer the Windows setup program available
-from http://tex.aanhet.net/epspdf/ or on CTAN as part of
-epspdf-extra. This setup program includes a minimal subset of Ruby/Tk,
-whereas this version requires separate installation of Ruby, and
-of Tcl/Tk if you want a GUI.
+Windows users: you may prefer the Windows setup program instead. It
+is available from http://tex.aanhet.net/epspdf/ and on CTAN as part
+of epspdf-extra. The setup program already provides the necessary
+pieces of Ruby and Tcl/Tk.
Mac OS X Leopard users: you may want to have a look at epspdftk.app,
which wraps epspdftk into a Mac OS X double-clickable "app" with the
help of a bit of AppleScript. Available from
http://tex.aanhet.net/epspdf/ or on CTAN as part of
-epspdf-extra. WARNING: the GUI interface will not work on Snow
-Leopard with the built-in Ruby.
+epspdf-extra.
+
+The files in the texlive subdirectory are NOT useful for a
+standalone installation. They are wrapper scripts for
+embedding epspdf and epspdftk into TeX Live.
diff --git a/Master/texmf-dist/doc/support/epspdf/README.tl b/Master/texmf-dist/doc/support/epspdf/README.tl
index 2b3f98e7295..d2775417f74 100644
--- a/Master/texmf-dist/doc/support/epspdf/README.tl
+++ b/Master/texmf-dist/doc/support/epspdf/README.tl
@@ -1,6 +1,5 @@
The scripts in this directory are for use by TeX Live and are
useless for a standalone install.
-For TeX Live 2009, only the shell scripts epspdf and epspdftk are
-still relevant, since under Windows epspdf and epspdftk are called
-via the generic wrapper.
+For TeX Live 2009 and later, epspdf and epspdftk use the generic
+wrappers for running scripts under Windows.
diff --git a/Master/texmf-dist/doc/support/epspdf/default.css b/Master/texmf-dist/doc/support/epspdf/default.css
index d4311458e08..5912f27711a 100644
--- a/Master/texmf-dist/doc/support/epspdf/default.css
+++ b/Master/texmf-dist/doc/support/epspdf/default.css
@@ -10,14 +10,25 @@ h1, h2, h3 {
font-weight: bold;
color: #008;
}
+
h1 {
font-size: xx-large;
margin-top: 12px;
margin-bottom: 6px;
}
-h1.display {
- text-align: center;
+
+#pagehead {
+ margin-left: 130px;
+ margin-bottom: 20px;
+}
+
+p#logo {
+ position: absolute;
+ left: 15px;
+ top: 0px;
+ margin-top: 0px;
}
+
h2 {
font-size: x-large;
margin-top: 12px;
@@ -32,10 +43,7 @@ p {
margin-bottom: 3px;
max-width: 60em;
}
-p.display {
- text-align: center;
- max-width: none;
-}
+
.fineprint {
font-size: x-small;
}
diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.install b/Master/texmf-dist/doc/support/epspdf/epspdf.install
index fec78698435..d982a1db824 100644
--- a/Master/texmf-dist/doc/support/epspdf/epspdf.install
+++ b/Master/texmf-dist/doc/support/epspdf/epspdf.install
@@ -11,12 +11,11 @@ Table of Contents
* [2]Features
* [3]Prerequisites
- * [4]Ruby/Tk
- * [5]Installation
- * [6]Preview programs
- * [7]Files
- * [8]Releases
- * [9]User Manual
+ * [4]Installation
+ * [5]Preview programs
+ * [6]Files
+ * [7]Releases
+ * [8]User Manual
Features
@@ -38,7 +37,7 @@ Features
Ghostscript can convert PostScript to pdf. However, few people are
prepared to deal with the ghostscript command-line. Several command-line
utilities try to help out, e.g. epstopdf, a2ping, and the convert utility
- from ImageMagick. But for most users this is still not good enough.
+ from ImageMagick. But many users simply want a GUI.
Epspdftk adds a GUI, with buttons to select options and with dialogs for
opening and saving files.
@@ -52,12 +51,17 @@ Features
does whatever back-and-forth conversions are necessary.
The command-line program epspdf is written in Ruby. Epspdftk, its GUI
- companion, in Ruby/Tk.
+ companion, in Tcl/Tk. Versions prior to 0.5 were written in Ruby/Tk.
- Starting with the 2008 edition, epspdf is included in TeX Live as an
- optional package, complete with wrappers epspdf and epspdftk which can be
+ Starting with the 2008 edition, TeX Live includes epspdf as an optional
+ package, complete with wrapper scripts epspdf and epspdftk which can be
called from the command-line without further ado.
+ There is also a third-party LaTeX package epspdfconversion which uses
+ epspdf for on-the-fly conversion of eps graphics to pdf, with options to
+ control grayscaling and boundingbox generation. See CTAN or your TeX
+ distribution.
+
Prerequisites
These are the required and optional prerequisites, which will be checked
@@ -67,8 +71,8 @@ Prerequisites
* pdftops from the xpdf suite, strongly recommended for better pdf to
PostScript conversions
* Ruby 1.8.x or 1.9.x
- * Tcl/Tk is only required for the GUI interface. The version (8.4 or
- 8.5) must be supported by your Ruby.
+ * Tcl/Tk is only required for the GUI interface. Versions 8.4 and 8.5
+ have been tested.
* Optional: viewers for PostScript and pdf
You may not have to install all of these yourself.
@@ -76,44 +80,31 @@ Prerequisites
Linux
On a current Linux distribution you can almost certainly install
- everything from your distribution's package repositories. Ruby's Tk
- bindings may be in a separate package, with a name such as libtcltk-ruby.
- As to PostScript- and pdf viewers: epspdf tests for several popular
- viewers, but the configuration screen also lets you specify viewers
- manually.
-
- Mac OS X (Tiger and Leopard)
-
- Ruby, Tcl/Tk and Ruby/Tk are already part of Tiger and Leopard.
-
- Ghostscript is included in MacTeX, but is also available via e.g.
- MacPorts.
+ everything from your distribution's package repositories. As to
+ PostScript- and pdf viewers: epspdf tests for several popular viewers, but
+ the configuration screen also lets you specify viewers manually.
- You can get pdftops from MacPorts as part of either Poppler or xpdf.
- Another source is [10]http://users.phg-online.de/tk/MOSXS/. 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.
-
- Mac OS X Snow Leopard
+ Mac OS X
- For Ghostscript and pdftops, see above.
+ Note. Version 0.5 has not been tested with Tiger.
- Unfortunately, in Snow Leopard Ruby's Tk bindings went missing, so the GUI
- interface won't work with the built-in Ruby; see [11]below. If you compile
- Ruby yourself from [12]source you get the Tk interface automatically. Call
- configure with a --enable-pthread option.
+ 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/.
- Snow Leopard's built-in Ruby is fine for command-line use and on-the-fly
- conversions.
+ If you want to compile xpdf 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.
Windows (Windows 2000 and later)
By itself, Windows lacks any of the prerequisites of epspdf. However, a
TeX installation may fill some of the gaps, and there is a special Windows
- installer which includes a partial Ruby installation. See the table below:
+ installer which takes care of the Ruby- and Tcl/Tk requirements. See the
+ table below:
- TeX distribution Installer Zipfile
+ TeX distribution Installer Zipfile
(1) MikTeX and TeX Live ≥ 2008 include a hidden Ghostscript which is
always installed, and which epspdf knows how to find. Caveat: although
older versions of TeX Live include a Ghostscript installer, it is not
@@ -122,70 +113,52 @@ Prerequisites
(2) With TeX Live ≥ 2008, you are better off installing the TeX Live
package, which also gives you wrappers for epspdf and epspdftk for use on
the command-line and for on-the-fly conversions. You still need to install
- Ruby 1.8 and Tcl/Tk.
- TeX Live[13](1) No additional Ruby, Tcl/Tk[14](2)
- requirements
- MiKTeX Pdftops (optional) Pdftops (optional); Ruby 1.8,
- Tcl/Tk(optional)
- Other/None Ghostscript, pdftops Ghostscript; pdftops(optional),
- (optional) Ruby 1.8, Tcl/Tk (optional)
+ Ruby and Tcl/Tk.
+ TeX Live[10](1) No additional Ruby, Tcl/Tk[11](2)
+ requirements
+ MiKTeX Pdftops (optional) Pdftops (optional); Ruby,
+ Tcl/Tk(optional)
+ Ghostscript, pdftops Ghostscript;
+ Other/None (optional) pdftops(optional), Ruby,
+ Tcl/Tk (optional)
URLs for the prerequisites
- Ghostscript and GSview ([15]http://pages.cs.wisc.edu/~ghost/)
+ Ghostscript and GSview ([12]http://pages.cs.wisc.edu/~ghost/)
Contains sources and Windows binaries. The Windows binaries come
with standard GUI Windows setup programs.
- XPDF ([16]http://www.foolabs.com/xpdf/)
+ XPDF ([13]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 ([17]http://users.phg-online.de/tk/MOSXS/)
+ XPDF, Mac OS X binaries ([14]http://users.phg-online.de/tk/MOSXS/)
These are universal binaries.
- TeX Live ([18]http://www.tug.org/texlive/)
+ TeX Live ([15]http://www.tug.org/texlive/)
TeX Live ≥ 2008 includes pdftops, Ghostscript and optionally
epspdf.
- MacTeX ([19]http://www.tug.org/mactex/)
+ MacTeX ([16]http://www.tug.org/mactex/)
MacTeX is based on TeX Live. Its set of add-ons includes
Ghostscript, and can be downloaded separately.
- The MacPorts Project ([20]http://www.macports.org/)
+ The MacPorts Project ([17]http://www.macports.org/)
MacTeX has Poppler- and xpdf packages either of which include
pdftops.
Ruby one-click installer for Windows (
- [21]http://rubyforge.org/projects/rubyinstaller/)
- Current versions (1.8.4 and later) require Tcl/Tk to be separately
- installed.
+ [18]http://rubyforge.org/projects/rubyinstaller/)
- Old releases of Ruby one-click installer (
- [22]http://rubyforge.org/frs/?group_id=167)
- Versions prior to 1.8.4 include Tcl/Tk.
-
- Ruby source code ([23]http://www.ruby-lang.org/en/downloads/)
+ Ruby source code ([19]http://www.ruby-lang.org/en/downloads/)
For those people who prefer to roll their own...
- ActiveTcl from ActiveState (
- [24]http://activestate.com/Products/ActiveTcl/
- Version 8.4 is the safer bet.
-
- Ruby's Tk interface library
-
- At the moment, the Ruby Tk interface is not as readily available as it has
- been: at some time during the 8.4 cycle, the Windows Ruby one-click
- installer dropped Tcl/Tk, and aimed instead to hook up to any
- already-installed Tcl/Tk. As to Ruby 1.9: at the moment I know of no
- easy-to-use installer on Windows which includes a Tk interface library. On
- Mac OS X 10.6 (Snow Leopard) the Ruby Tk interface library also went
- missing, although both Ruby and Tcl/Tk are still included.
+ Tcl Developer Xchange ([20]http://www.tcl.tk/)
- I am working on a pure Tcl/Tk interface, i.e.a Tcl/Tk script which calls
- epspdf as a program, not as a library, but I can give no ETA. This will
- eliminate dependence on a Ruby/Tk interface library.
+ ActiveTcl from ActiveState (
+ [21]http://activestate.com/Products/ActiveTcl/
Installation
@@ -197,31 +170,37 @@ Installation
Windows setup program
- Download the [25]epspdftk setup program. You can run it in the usual way,
+ Download the [22]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.
+ The setup program has been created with [23]NSIS
+
+ .
+
Windows zipfile
- Download the [26]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
+ Download the [24]epspdf zip file, unpack it somewhere and create a
+ batchfile epspdf.bat such as
+
+ ruby "<path_to_epspdf.rb>" %*
- "<path_to_ruby.exe>" "<path_to_epspdf.rb>" %*
+ for epspdf.rb, and a batchfile epspdftk.bat
- Similarly for epspdftk. With such a batchfile, the caller has to take care
- of quoting:
+ wish85 "<path_to_epspdftk.tcl>" %1
- epspdf "my file.eps" "my file.pdf"
+ for epspdftk.tcl. The wish executable might also be named wish[.exe] or
+ wish84[.exe]. The first command-line parameter will be interpreted as
+ startup directory for the file browser. Make sure that wish85, ruby and
+ these batchfiles are on your searchpath.
Epspdf[tk] has been tested with Windows 2000, Windows XP and Windows 7.
Unix/Linux
- Download the [27]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 create a shell script
- epspdf such as
+ Download the [25]tar.gz archive and unpack it in some directory. If you
+ plan to use epspdf.rb from the command-line, create a shell script epspdf
+ such as
#!/bin/sh
<path_to_epspdf>/epspdf.rb "$@"
@@ -233,15 +212,10 @@ Installation
Mac OS X
- You can install as for Unix/Linux. Here, too, all files should be in the
- same directory.
-
- There is also a compressed disk image epspdf.x.x.x.dmg.gz which wraps
- epspdftk into a Max OS X "app". Double-click once to expand, a second time
- to mount, then drag epspdftk.app to the Applications folder. The current
- version has been created and tested with Leopard. As pointed out
- [28]above, under Snow Leopard the GUI program epspdftk will not work
- without a third-party Ruby/Tk.
+ Although you can install as for Unix/Linux, there is also a compressed
+ disk image epspdf.x.x.x.dmg.gz which wraps epspdftk into a Max OS X "app".
+ Double-click once to expand, a second time to mount, then drag
+ epspdftk.app to the Applications folder.
Epspdf mostly duplicates functionality of Preview. But having an alternate
conversion engine means that you can have another shot at problem files.
@@ -250,51 +224,58 @@ Preview programs
Windows
- Epspdftk will use the default Windows programs 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. For Windows
- only, there is an additional "View with..." button to select a viewer
- yourself.
+ Epspdftk will use the default Windows programs for PostScript and pdf.
Unix/Linux
- Supported PostScript viewers include evince, gv, gsview and okular. These
- are also listed as pdf viewers. Additional pdf viewers are xpdf, gpdf,
- epdfview and acroread/Adobe Reader. You can also specify a previewer
- manually in the configuration screen; see the [29]user manual..
+ Supported PostScript viewers include evince, gv and okular. These are also
+ listed as pdf viewers. Additional pdf viewers are xpdf, kpdf, epdfview and
+ acroread/Adobe Reader. You can also specify a previewer manually in the
+ configuration screen; see the [26]user manual..
Mac OS X
- Epspdftk will always use the default pdf viewer under OS X, usually
- Preview or Adobe Reader.
+ Epspdftk uses the default pdf viewer under OS X, usually Preview or Adobe
+ Reader.
Files
- * [30]epspdf.0.4.3.tgz preferred for Unix and Mac OS X; GUI fails under
- OS X Snow Leopard with built-in Ruby
- * [31]epspdf.0.4.3.zip preferred for Windows
- * [32]epspdf.0.4.3.exe Windows setup program, including Ruby/Tk subset
- * [33]epspdftk.0.4.3.dmg.gz; built and tested on Leopard
+ * [27]epspdf.0.5.tgz preferred for Unix and Mac OS X
+ * [28]epspdf.0.5.zip preferred for Windows if you don't want to use the
+ installer below
+ * [29]epspdf.0.5.exe Windows setup program, including Ruby subset. The
+ epspdftk script has been packaged with a basic Tcl/Tk into a single
+ exe file (starpack).
+ * [30]epspdftk.0.5.dmg.gz compressed disk image with epspdftk wrapped
+ into a Mac OS X "app"
Older releases
- * [34]epspdftk.0.4.2.dmg.gz; tested on Tiger and Leopard
- * [35]epspdf.0.3.0.tgz for Unix and Mac OS X
- * [36]epspdf.0.3.0.zip for Windows
- * [37]epspdf.0.3.0.exe Windows setup program
- * [38]epspdf.0.2.12.tgz for Unix, including Mac OS X
- * [39]epspdf.0.2.12.zip for Windows
- * [40]epspdf.0.2.12.exe Windows setup program
- * [41]epspdf.0.2.01.tgz for Unix and Mac OS X
- * [42]epspdf.0.2.01.zip for Windows
- * [43]epspdf.0.2.exe, Windows setup program
- * [44]epspdf_app.0.2.01.zip Mac OS X applet for starting epspdftk.rb
+ * [31]epspdftk.0.4.3.dmg.gz; GUI doesn't work on Snow Leopard
+ * [32]epspdf.0.4.3.tgz for Unix and Mac OS X
+ * [33]epspdf.0.4.3.zip for Windows
+ * [34]epspdf.0.4.3.exe Windows setup program
+ * [35]epspdftk.0.4.2.dmg.gz; tested on Tiger and Leopard
+ * [36]epspdf.0.3.0.tgz for Unix and Mac OS X
+ * [37]epspdf.0.3.0.zip for Windows
+ * [38]epspdf.0.3.0.exe Windows setup program
+ * [39]epspdf.0.2.12.tgz for Unix, including Mac OS X
+ * [40]epspdf.0.2.12.zip for Windows
+ * [41]epspdf.0.2.12.exe Windows setup program
+ * [42]epspdf.0.2.01.tgz for Unix and Mac OS X
+ * [43]epspdf.0.2.01.zip for Windows
+ * [44]epspdf.0.2.exe, Windows setup program
+ * [45]epspdf_app.0.2.01.zip Mac OS X applet for starting epspdftk.rb
Releases
+ 0.5
+ Current version. Ruby/Tk GUI replaced with Tcl/Tk GUI. Starpack
+ wrapper for Windows setup version.
+
0.4.3
- Current version. Fixes for compatibility with Ruby 1.9 and, under
- Windows, for newer Ghostscript versions. Documentation updates.
+ Fixes for compatibility with Ruby 1.9 and, under Windows, for
+ newer Ghostscript versions. Documentation updates.
0.4.2
More liberal documentation license. Slight documentation updates.
@@ -352,7 +333,7 @@ Releases
--------------------------------------------------------------------------
- Last revised: Januari 27, 2010
+ Last revised: March 29, 2010
References
@@ -360,44 +341,45 @@ References
1. http://tex.aanhet.net/epspdf/
2. http://tex.aanhet.net/epspdf/index.html#features
3. http://tex.aanhet.net/epspdf/index.html#prerequisites
- 4. http://tex.aanhet.net/epspdf/index.html#rubytk
- 5. http://tex.aanhet.net/epspdf/index.html#install
- 6. http://tex.aanhet.net/epspdf/index.html#preview
- 7. http://tex.aanhet.net/epspdf/index.html#files
- 8. http://tex.aanhet.net/epspdf/index.html#releases
- 9. http://tex.aanhet.net/epspdf/epspdf.pdf
- 10. http://users.phg-online.de/tk/MOSXS/
- 11. http://tex.aanhet.net/epspdf/index.html#rubytk
- 12. http://www.ruby-lang.org/en/downloads/
- 13. http://tex.aanhet.net/epspdf/index.html#tlnote
- 14. http://tex.aanhet.net/epspdf/index.html#tlzipnote
- 15. http://pages.cs.wisc.edu/~ghost/
- 16. http://www.foolabs.com/xpdf/
- 17. http://users.phg-online.de/tk/MOSXS/
- 18. http://www.tug.org/texlive/
- 19. http://www.tug.org/mactex/
- 20. http://www.macports.org/
- 21. http://rubyforge.org/projects/rubyinstaller/
- 22. http://rubyforge.org/frs/?group_id=167
- 23. http://www.ruby-lang.org/en/downloads/
- 24. http://activestate.com/Products/ActiveTcl/
- 25. http://tex.aanhet.net/epspdf/epspdf.0.4.3.exe
- 26. http://tex.aanhet.net/epspdf/epspdf.0.4.3.zip
- 27. http://tex.aanhet.net/epspdf/epspdf.0.4.3.tgz
- 28. http://tex.aanhet.net/epspdf/index.html#rubytk
- 29. http://tex.aanhet.net/epspdf/epspdf.pdf
- 30. http://tex.aanhet.net/epspdf/epspdf.0.4.3.tgz
- 31. http://tex.aanhet.net/epspdf/epspdf.0.4.3.zip
- 32. http://tex.aanhet.net/epspdf/epspdf.0.4.3.exe
- 33. http://tex.aanhet.net/epspdf/epspdftk.0.4.3.dmg.gz
- 34. http://tex.aanhet.net/epspdf/epspdftk.0.4.2.dmg.gz
- 35. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz
- 36. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip
- 37. http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe
- 38. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz
- 39. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip
- 40. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe
- 41. http://tex.aanhet.net/epspdf/epspdf.0.2.01.tgz
- 42. http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip
- 43. http://tex.aanhet.net/epspdf/epspdf.0.2.exe
- 44. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip
+ 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#releases
+ 8. http://tex.aanhet.net/epspdf/epspdf.pdf
+ 9. http://users.phg-online.de/tk/MOSXS/
+ 10. http://tex.aanhet.net/epspdf/index.html#tlnote
+ 11. http://tex.aanhet.net/epspdf/index.html#tlzipnote
+ 12. http://pages.cs.wisc.edu/~ghost/
+ 13. http://www.foolabs.com/xpdf/
+ 14. http://users.phg-online.de/tk/MOSXS/
+ 15. http://www.tug.org/texlive/
+ 16. http://www.tug.org/mactex/
+ 17. http://www.macports.org/
+ 18. http://rubyforge.org/projects/rubyinstaller/
+ 19. http://www.ruby-lang.org/en/downloads/
+ 20. http://www.tcl.tk/
+ 21. http://activestate.com/Products/ActiveTcl/
+ 22. http://tex.aanhet.net/epspdf/epspdf.0.5.exe
+ 23. http://nsis.sourceforge.net/
+ 24. http://tex.aanhet.net/epspdf/epspdf.0.5.zip
+ 25. http://tex.aanhet.net/epspdf/epspdf.0.5.tgz
+ 26. http://tex.aanhet.net/epspdf/epspdf.pdf
+ 27. http://tex.aanhet.net/epspdf/epspdf.0.5.tgz
+ 28. http://tex.aanhet.net/epspdf/epspdf.0.5.zip
+ 29. http://tex.aanhet.net/epspdf/epspdf.0.5.exe
+ 30. http://tex.aanhet.net/epspdf/epspdftk.0.5.dmg.gz
+ 31. http://tex.aanhet.net/epspdf/epspdftk.0.4.3.dmg.gz
+ 32. http://tex.aanhet.net/epspdf/epspdf.0.4.3.tgz
+ 33. http://tex.aanhet.net/epspdf/epspdf.0.4.3.zip
+ 34. http://tex.aanhet.net/epspdf/epspdf.0.4.3.exe
+ 35. http://tex.aanhet.net/epspdf/epspdftk.0.4.2.dmg.gz
+ 36. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz
+ 37. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip
+ 38. http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe
+ 39. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz
+ 40. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip
+ 41. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe
+ 42. http://tex.aanhet.net/epspdf/epspdf.0.2.01.tgz
+ 43. http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip
+ 44. http://tex.aanhet.net/epspdf/epspdf.0.2.exe
+ 45. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip
diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.pdf b/Master/texmf-dist/doc/support/epspdf/epspdf.pdf
index f438a668c0b..3aa0ae1ca2c 100644
--- a/Master/texmf-dist/doc/support/epspdf/epspdf.pdf
+++ b/Master/texmf-dist/doc/support/epspdf/epspdf.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.texi b/Master/texmf-dist/doc/support/epspdf/epspdf.texi
index 36d69d53327..2001ccb0675 100644
--- a/Master/texmf-dist/doc/support/epspdf/epspdf.texi
+++ b/Master/texmf-dist/doc/support/epspdf/epspdf.texi
@@ -19,9 +19,10 @@
@textfonts
@rm
@raggedbottom
+@hyphenation{epspdf-tk epspdf}
@end iftex
-@set version 0.4.3
+@set version 0.5
@set homepage http://tex.aanhet.net/epspdf/
@setchapternewpage off
@@ -41,6 +42,8 @@ without any warranty.
@end copying
@titlepage
+@sp 1
+@center @image{images/logo,,.4in}
@sp 2
@center @titlefont {Epspdf and epspdftk User Manual}
@sp 1
@@ -54,7 +57,7 @@ without any warranty.
@contents
@ifnottex
-@node Top
+@node Top, Usage, (dir), (dir)
@top Epspdf and epsdftk
@insertcopying
@@ -66,7 +69,7 @@ without any warranty.
* Notes on PostScript and pdf::
* Bitmapped graphics for @LaTeX{} and pdflatex::
* Troubleshooting::
-* Changes in version 0.4::
+* Change history::
@detailmenu
--- The Detailed Node Listing ---
@@ -107,12 +110,18 @@ Troubleshooting
* Grayscaling fails::
* Part of the graphic gets cut off::
* Fonts look ugly::
+* epspdftk quit unexpectedly (Mac OS X applet)::
* Resources for troubleshooting::
+Change history
+
+* Version 0.5::
+* Version 0.4::
+
@end detailmenu
@end menu
-@node Usage
+@node Usage, Command-line usage, Top, Top
@chapter Usage
@menu
@@ -123,7 +132,7 @@ Troubleshooting
* The configuration screen::
@end menu
-@node Overview
+@node Overview, Viewing, Usage, Usage
@section Overview
Epspdftk converts files between eps, pdf and general
@@ -140,18 +149,14 @@ displayed in the box in the upper part of the screen.
@end iftex
@image{images/cnv_osx,,3in}
-@node Viewing
+@node Viewing, Conversion options, Overview, Usage
@section Viewing
The View button at the bottom of the screen calls an appropriate
external viewer.
-@i{Windows:} Epspdftk simply tries to use the default Open command. A
-second button, labeled @i{View with...}, lets the user select a
-different program to view the file.
-
-For OS X the viewer is also the default program, but there is no @i{View
-with...} button.
+@i{Windows and OS X:} Epspdftk simply tries to use the default Open
+command.
Under Linux the PostScript- and pdf viewers are
configurable; see @ref{The configuration screen}.
@@ -159,7 +164,7 @@ configurable; see @ref{The configuration screen}.
The View button is grayed if epspdf thinks that there is no
previewer for the current file.
-@node Conversion options
+@node Conversion options, Converting, Viewing, Usage
@section Conversion options
@anchor{gray}@i{Grayscaling:} Simple color figures can be converted to
@@ -175,24 +180,22 @@ if a single page is converted.
single page or selecting all pages. When converting to eps you are
restricted to a single page.
-For general PostScript files, there is no quick way to determine
-the number of pages, so the program won't check beforehand whether
-you picked an existing page. If you picked a non-existent page, the
-program will abort. If you don't like that, convert the entire
-document to pdf first -- which will be done behind the scenes
-anyhow.
+For general PostScript files, there is no quick way to determine the
+number of pages, so the program may not check beforehand whether you
+picked an existing page. If you don't like that, convert the entire
+document to pdf first -- which will be done behind the scenes anyhow.
Specifying options such as grayscaling or page selection may require
several roundtrips between PostScript or eps and pdf.
-@node Converting
+@node Converting, The configuration screen, Conversion options, Usage
@section Converting
The Convert and save... button calls up a file save dialog. After a
successful conversion, the result becomes the new current file, so you
can judge the result by pressing the View button again.
-@node The configuration screen
+@node The configuration screen, , Converting, Usage
@section The configuration screen
@image{images/config_lnx,3in}
@@ -209,8 +212,7 @@ manually.
For Windows and Mac OS X, there is no such configuration option. Epspdf
will use the program associated with the file type, which can be
-configured outside epspdf. Under Windows, you can use the ``View
-with...'' button instead.
+configured outside epspdf.
@subsection Options for converting to pdf
Double-check the setting ``Target use'' under ``Conversion to
@@ -228,15 +230,14 @@ and Ps2pdf.htm.
For conversion the other way you may opt @i{not} to use pdftops even if
it is available. In this case, the conversion will be done by
Ghostscript. Characters may be converted to drawn shapes or little
-bitmaps so this is not recommended.
+bitmaps so this is not recommended if the file uses fonts.
Under Windows, this is also the place to point the program to the
location of pdftops.exe.
@anchor{hires}@subsection Hires BoundingBox
-Uncheck the option ``Use hires boundingbox if possible'' if otherwise
-the computed boundingbox is slightly too tight, resulting in some
-clipping. It has two effects:
+Uncheck the option ``Use hires boundingbox if possible'' if your
+conversions come out slightly clipped. It has two effects:
@itemize @bullet
@item
When converting to pdf, it uses the standard rather than the hires
@@ -247,12 +248,11 @@ the standard boundingbox, except where it would make any boundingbox
coordinate negative.
@end itemize
-@node Command-line usage
+@node Command-line usage, Notes on PostScript and pdf, Usage, Top
@chapter Command-line usage
-epspdf.rb, the library for epspdftk.rb, does double duty as command-line
-version of epspdftk.rb. It shares configuration settings with
-epspdftk.rb.
+epspdf.rb is the backend of epspdftk, but it can also be used
+standalone. It shares configuration settings with epspdftk.tcl.
It is strongly recommended to invoke epspdf.rb via a wrapper script
epspdf or epspdf.bat on the search path, e.g.
@@ -279,13 +279,13 @@ epspdf [@var{options}] @var{infile} @var{outfile}
* Option summary::
@end menu
-@node Option summary
+@node Option summary, , Command-line usage, Command-line usage
@section Option summary
Typing @kbd{epspdf --help} gives you the following summary:
@example
$ epspdf --help
-Epspdf version 0.4.3
+Epspdf version 0.5
Copyright (C) 2006, 2008, 2009, 2010 Siep Kroonenberg
Convert between [e]ps and pdf formats
Usage: epspdf.rb [options] infile [outfile]
@@ -303,7 +303,6 @@ Default for outfile is file.eps if infile is file.pdf
-T, --target=TARGET Target use of pdf; one of
default, printer, prepress, screen, ebook
-N, --pdfversion=PDFVERSION Pdf version to be generated
- -V, --version=PDFVERSION Deprecated; use `-N' or `--pdfversion'.
-I Ignore pdftops even if available
(default: use if available)
-U Use pdftops if available
@@ -317,12 +316,13 @@ Default for outfile is file.eps if infile is file.pdf
-i, --info Info: display detected filetype
-s Save (some) settings
-d Debug: don't remove temp files
+ --gui[=ACTION] Do not use; reserved for GUI
- -v Prints version info
+ -v, --version Prints version info
-h, --help Show this message
@end example
-@node Notes on PostScript and pdf
+@node Notes on PostScript and pdf, Bitmapped graphics for @LaTeX{} and pdflatex, Command-line usage, Top
@chapter Notes on PostScript and pdf
@menu
@@ -334,7 +334,7 @@ Default for outfile is file.eps if infile is file.pdf
* Exporting PostScript from Windows programs::
@end menu
-@node Bitmapped and vector
+@node Bitmapped and vector, Font embedding, Notes on PostScript and pdf, Notes on PostScript and pdf
@section Bitmapped and vector
Pictures can be described either in terms of pixels, or more abstractly,
@@ -361,7 +361,7 @@ converts the other way. With the screen- and ebook ``Target use''
option, included bitmaps tend to be downsampled, i.e. reduced to a lower
resolution.
-@node Font embedding
+@node Font embedding, Eps preview headers, Bitmapped and vector, Notes on PostScript and pdf
@section Font embedding
When converting to pdf, Ghostscript handles font embedding differently
@@ -377,7 +377,7 @@ unless you have pdftops.
If target use is set to ``screen'', then standard fonts will be removed
instead of added. This option may also cause downsampling of bitmaps.
-@node Eps preview headers
+@node Eps preview headers, Bounding- and other boxes, Font embedding, Notes on PostScript and pdf
@section Eps preview headers
Preview headers are quietly stripped from eps files. These
@@ -386,7 +386,7 @@ represent eps files on screen without having to interpret the
PostScript code itself. Epspdf currently has no option to preserve
or add them.
-@node Bounding- and other boxes
+@node Bounding- and other boxes, Orientation, Eps preview headers, Notes on PostScript and pdf
@section Bounding- and other boxes
A PostScript file may have a page size and a boundingbox defined. A pdf
@@ -403,7 +403,7 @@ Both Ghostscript and pdftops have some parameters for setting or using
these boxes; consult Ps2pdf.htm from the Ghostscript documentation and
``pdftops --help'' or ``man pdftops''.
-@node Orientation
+@node Orientation, Exporting PostScript from Windows programs, Bounding- and other boxes, Notes on PostScript and pdf
@section Orientation
There appears to be no reliable way to set orientation for PostScript-
@@ -413,7 +413,7 @@ boundingbox. It may help to change the extension from ``.eps'' to
``.ps'' before converting to pdf. In this case, let epspdf generate a
new boundingbox.
-@node Exporting PostScript from Windows programs
+@node Exporting PostScript from Windows programs, , Orientation, Notes on PostScript and pdf
@section Exporting PostScript from Windows programs
Often, the only way to get EPS or PostScript from a Windows program is
@@ -432,7 +432,7 @@ uses a printer driver in the background. For faithful conversion,
pick wmf2eps; for subsequent editing, choose TpX. Both programs are
available from @url{http://www.tug.org/ctan.html}.
-@node Bitmapped graphics for @LaTeX{} and pdflatex
+@node Bitmapped graphics for @LaTeX{} and pdflatex, Troubleshooting, Notes on PostScript and pdf, Top
@chapter Bitmapped graphics for @LaTeX{} and pdflatex
pdflatex can use graphics in .png format (best for screenshots) and .jpg
@@ -445,7 +445,7 @@ stuck with .eps format. Tips for converting to .eps:
* Windows::
@end menu
-@node Linux
+@node Linux, Mac OS X, Bitmapped graphics for @LaTeX{} and pdflatex, Bitmapped graphics for @LaTeX{} and pdflatex
@section Linux
@table @emph
@@ -463,13 +463,13 @@ pre-installed on Linux, and is also available for other platforms. The
GIMP can save in eps format.
@end table
-@node Mac OS X
+@node Mac OS X, Windows, Linux, Bitmapped graphics for @LaTeX{} and pdflatex
@section Mac OS X
Mac OS X's built-in Preview application can read most bitmapped formats
and save them as .pdf, which epspdf can convert to .eps.
-@node Windows
+@node Windows, , Mac OS X, Bitmapped graphics for @LaTeX{} and pdflatex
@section Windows
Windows is not a particularly friendly environment for PostScript and
@@ -489,7 +489,7 @@ grayscale image. It produces larger files than sam2p.
* GUI use of sam2p and bmeps::
@end menu
-@node GUI use of sam2p and bmeps
+@node GUI use of sam2p and bmeps, , Windows, Windows
@subsection GUI use of sam2p and bmeps
Create a batchfile @file{bitmap2eps.bat} with contents
@@ -509,24 +509,25 @@ browse to this file bitmap2eps.bat, resulting in conversion to .eps. The
next time you do this with a file of the same type, bitmap2eps.bat will
already be in the list of possible programs for opening the file.
-@node Troubleshooting
+@node Troubleshooting, Change history, Bitmapped graphics for @LaTeX{} and pdflatex, Top
@chapter Troubleshooting
@menu
* Grayscaling fails::
* Part of the graphic gets cut off::
* Fonts look ugly::
+* epspdftk quit unexpectedly (Mac OS X applet)::
* Resources for troubleshooting::
@end menu
-@node Grayscaling fails
+@node Grayscaling fails, Part of the graphic gets cut off, Troubleshooting, Troubleshooting
@section Grayscaling fails
See above, under @ref{gray,,Grayscaling}. Epspdf is
limited by what can be done by the backend tools, i.e. Ghostscript
and pdftops. In particular, epspdf cannot grayscale bitmapped data.
-@node Part of the graphic gets cut off
+@node Part of the graphic gets cut off, Fonts look ugly, Grayscaling fails, Troubleshooting
@section Part of the graphic gets cut off
Things to try:
@@ -545,33 +546,44 @@ high-resolutuion boundingbox. Command-line option: ``-n'' or
``--no-hires''.
@end itemize
-@node Fonts look ugly
+@node Fonts look ugly, epspdftk quit unexpectedly (Mac OS X applet), Part of the graphic gets cut off, Troubleshooting
@section Fonts look ugly
If Ghostscript has to do the conversion from pdf to ps then text will
not remain text, but will be replaced by drawn shapes or bitmaps. Try
-to get hold of the xpdf suite, which includes pdftops, especially if
-your files contain serious amount of text.
+to get hold of the xpdf suite, which includes pdftops.
+
+@node epspdftk quit unexpectedly (Mac OS X applet), Resources for troubleshooting, Fonts look ugly, Troubleshooting
+@section Epspdftk quit unexpectedly (Mac OS X applet)
-@node Resources for troubleshooting
+This sometimes happens to me when I start epspdftk from the AppleScript
+applet. Unfortunately, I have no idea where this comes from.
+
+Try the ``Reopen'' button in the popup dialog. If this repeatedly fails,
+install the regular Unix edition instead and run it from the
+command-line.
+
+@node Resources for troubleshooting, , epspdftk quit unexpectedly (Mac OS X applet), Troubleshooting
@section Resources for troubleshooting
-@i{Logfile.} 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 @file{c:\Documents and
-Settings\@var{your user name}}. Otherwise, open a DOS box and type
-@kbd{echo %USERPROFILE%}, which will produce this
-information.
+@i{Logfile.} The GUI has a button for viewing log output. This same
+output is also written to a file @file{epspdf.log}. For Linux/Unix/Mac
+OS X this is in a subdirectory .epspdf of your home directory; for
+Windows it is in a subdirectory epspdf of @file{%APPDATA%}. This APPDATA
+directory may be @file{c:\Documents and Settings\@var{your user
+name}\Application Data} or @file{c:\Users\@var{your user
+name}\AppData\Roaming}. Otherwise, open a command prompt and type
+@kbd{echo %APPDATA%}, which will produce this information.
-This logfile lists all Ghostscript- and pdftops program
+The logfile lists all epspdf calls and all Ghostscript- and pdftops
calls plus error information. ``EPCallError'' is probably a program
-error. 'EPSystemError'' is more likely caused by a faulty file, but
-may be a program error as well.
+error. 'EPSystemError'' is more likely caused by a faulty file, but may
+be a program error as well.
@i{Temporary files.} The temporary files may give clues as
-well. They will be deleted at the end of the session (for the
+well. Uncheck the button ``Remove temp files'', or for the
command-line version, give a -d parameter to keep the temporary
-files). Check the logfile as to which temporary files have been
+files. Check the log(file) as to which temporary files have been
created.
@anchor{Documentation}@i{Ghostscript- and pdftops documentation.} For
@@ -579,12 +591,56 @@ Ghostscript, the most important files are Ps2pdf.htm and Use.htm. For
pdftops, type @kbd{pdftops -h}. For Unix, there is also a man page, and
for Windows there is a file pdftops.txt in the distribution zip.
-@node Changes in version 0.4
-@chapter Changes in version 0.4
+@node Change history, , Troubleshooting, Top
+@chapter Change history
+
+@menu
+* Version 0.5::
+* Version 0.4::
+@end menu
+
+@node Version 0.5, Version 0.4, Change history, Change history
+@section Version 0.5
+
+The GUI has been rewritten in Tcl/Tk, removing the dependence on the
+Ruby/Tk interface library.
+
+The Windows installer now installs a small Ruby subset and the standard
+epspdf distribution, but with epspdftk.tcl replaced with a starpack: a
+single executable containing @file{epspdftk.tcl} and a Tcl/Tk
+runtime. See @url{http://wiki.tcl.tk/52}.
+
+Epspdf now uses its own subdirectory for both the logfile and the
+configuration file. For Linux/Unix/Mac OS X this is
+@file{$HOME/.epspdf}, for Windows it is @file{%APPDATA%\epspdf}.
+On all supported platforms, settings are stored in the file
+@file{config} in this directory. Under Windows, the registry is no
+longer used for this.
+
+A button has been added to view log output.
+
+There is a second new button ``Remove temp files'', which is normally
+checked, causing temporary files to be deleted after each
+conversion. Unchecking this button may be useful for troubleshooting. In
+previous versions, temporary files were deleted at the end of the entire
+epspdftk session but that has become less practical now that the GUI and
+epspdf itself have become two separate programs.
+
+The ``Open with...'' option for Windows has been dropped for technical
+reasons.
+
+The ``--version'' option now prints the version string instead of
+setting the desired pdf version.
+
+The ``--info'' option now also prints the number of pages for pdf
+files.
+
+@node Version 0.4, , Version 0.5, Change history
+@section Version 0.4
Hi-res boundingboxes are now supported. By default, conversion from eps
to pdf now uses the hires boundingbox as ``page'' to determine the page
-dmensions of the pdf file. Other conversions preserve or generate a
+dimensions of the pdf file. Other conversions preserve or generate a
hires boundingbox.
Under Windows, the new version looks for an installed @TeX{} and will
diff --git a/Master/texmf-dist/doc/support/epspdf/images/cnv_osx.png b/Master/texmf-dist/doc/support/epspdf/images/cnv_osx.png
index 3c326785d23..aed566aea2e 100644
--- a/Master/texmf-dist/doc/support/epspdf/images/cnv_osx.png
+++ b/Master/texmf-dist/doc/support/epspdf/images/cnv_osx.png
Binary files differ
diff --git a/Master/texmf-dist/doc/support/epspdf/images/config_lnx.png b/Master/texmf-dist/doc/support/epspdf/images/config_lnx.png
index 5988934e22f..8f6036867f5 100644
--- a/Master/texmf-dist/doc/support/epspdf/images/config_lnx.png
+++ b/Master/texmf-dist/doc/support/epspdf/images/config_lnx.png
Binary files differ
diff --git a/Master/texmf-dist/doc/support/epspdf/images/epspdf.png b/Master/texmf-dist/doc/support/epspdf/images/epspdf.png
new file mode 100644
index 00000000000..db0f09c6acb
--- /dev/null
+++ b/Master/texmf-dist/doc/support/epspdf/images/epspdf.png
Binary files differ
diff --git a/Master/texmf-dist/doc/support/epspdf/images/logo.pdf b/Master/texmf-dist/doc/support/epspdf/images/logo.pdf
new file mode 100644
index 00000000000..22368065be8
--- /dev/null
+++ b/Master/texmf-dist/doc/support/epspdf/images/logo.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/epspdf/images/main_w32.png b/Master/texmf-dist/doc/support/epspdf/images/main_w32.png
index ab7aa189140..7bea79fbf07 100644
--- a/Master/texmf-dist/doc/support/epspdf/images/main_w32.png
+++ b/Master/texmf-dist/doc/support/epspdf/images/main_w32.png
Binary files differ
diff --git a/Master/texmf-dist/doc/support/epspdf/index.html b/Master/texmf-dist/doc/support/epspdf/index.html
index 3503e71f931..5df7df22fca 100644
--- a/Master/texmf-dist/doc/support/epspdf/index.html
+++ b/Master/texmf-dist/doc/support/epspdf/index.html
@@ -12,14 +12,20 @@
</head><body>
-<h1 class="display">Epspdf and epspdftk</h1>
+<div id="pagehead">
-<p class="display">A multiplatform GUI- and command-line converter
+<h1>Epspdf and epspdftk</h1>
+
+<p>A multiplatform GUI- and command-line converter
for [e]ps and pdf.</p>
-<p class="display"><i>Siep Kroonenberg,<br/><tt>siepo at cybercomm
+<p><i>Siep Kroonenberg,<br/><tt>siepo at cybercomm
dot nl</tt></i></p>
+</div>
+
+<p id="logo"><img src="images/epspdf.png" alt=""/></p>
+
<p><a href="http://tex.aanhet.net/epspdf/">Current online version of
this page</a></p>
@@ -28,7 +34,6 @@ this page</a></p>
<ul>
<li><a href="#features">Features</a></li>
<li><a href="#prerequisites">Prerequisites</a></li>
-<li><a href="#rubytk">Ruby/Tk</a></li>
<li><a href="#install">Installation</a></li>
<li><a href="#preview">Preview programs</a></li>
<li><a href="#files">Files</a></li>
@@ -59,8 +64,8 @@ derivatives, eps and pdf are the preferred graphics formats.</p>
<p>Ghostscript can convert PostScript to pdf. However, few people
are prepared to deal with the ghostscript command-line. Several
command-line utilities try to help out, e.g. epstopdf, a2ping, and
-the convert utility from ImageMagick. But for most users this is
-still not good enough.</p>
+the convert utility from ImageMagick. But many users simply want a
+GUI.</p>
<p>Epspdftk adds a GUI, with buttons to select options and with
dialogs for opening and saving files.</p>
@@ -74,14 +79,20 @@ multipage PostScript- and pdf documents. Epspdf will use pdftops if
it can find it, and silently 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>The command-line program epspdf is written in Ruby. Epspdftk, its
+GUI companion, in Tcl/Tk. Versions prior to 0.5 were written in
+Ruby/Tk.</p>
-<p>Starting with the 2008 edition, epspdf is included in TeX Live as
-an optional package, complete with wrappers epspdf and
+<p>Starting with the 2008 edition, TeX Live includes epspdf as
+an optional package, complete with wrapper scripts epspdf and
epspdftk which can be called from the command-line without further
ado.</p>
+<p>There is also a third-party LaTeX package epspdfconversion which
+ uses epspdf for on-the-fly conversion of eps graphics to pdf, with
+ options to control grayscaling and boundingbox generation. See
+ CTAN or your TeX distribution.</p>
+
<h2><a name="prerequisites"/>Prerequisites</h2>
<p>These are the required and optional prerequisites, which will be
@@ -91,8 +102,8 @@ checked for when epspdf starts:</p>
<li>pdftops from the xpdf suite, strongly recommended for better
pdf to PostScript conversions</li>
<li>Ruby 1.8.<i>x</i> or 1.9.<i>x</i></li>
-<li>Tcl/Tk is only required for the GUI interface. The version (8.4
- or 8.5) must be supported by your Ruby.</li>
+<li>Tcl/Tk is only required for the GUI interface. Versions 8.4
+ and 8.5 have been tested.</li>
<li>Optional: viewers for PostScript and pdf</li>
</ul>
@@ -101,47 +112,31 @@ checked for when epspdf starts:</p>
<h3>Linux</h3>
<p>On a current Linux distribution you can almost certainly install
-everything from your distribution's package repositories. Ruby's Tk
-bindings may be in a separate package, with a name such as
-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>
+everything from your distribution's package repositories. As to
+PostScript- and pdf viewers: epspdf tests for several popular
+viewers, but the configuration screen also lets you specify viewers
+manually.</p>
-<h3>Mac OS X (Tiger and Leopard)</h3>
+<h3>Mac OS X</h3>
-<p>Ruby, Tcl/Tk and Ruby/Tk are already part of Tiger and
- Leopard.</p>
+<p><b>Note.</b> Version 0.5 has not been tested with Tiger.</p>
-<p>Ghostscript is included in MacTeX, but is also available via
-e.g. MacPorts.</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 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>. 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
+<p>If you want to compile xpdf 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>Mac OS X Snow Leopard</h3>
-
-<p>For Ghostscript and pdftops, see above.</p>
-
-<p>Unfortunately, in Snow Leopard Ruby's Tk bindings went missing,
- so the GUI interface won't work with the built-in Ruby;
- see <a href="#rubytk">below</a>. If you compile Ruby yourself
- from <a href="http://www.ruby-lang.org/en/downloads/">source</a>
- you get the Tk interface automatically. Call <tt>configure</tt>
- with a <tt>--enable-pthread</tt> option.</p>
-
-<p>Snow Leopard's built-in Ruby is fine for command-line use and
- on-the-fly conversions.</p>
-
<h3>Windows (Windows 2000 and later)</h3>
<p>By itself, Windows lacks any of the prerequisites of
epspdf. However, a TeX installation may fill some of the gaps, and
-there is a special Windows installer which includes a partial Ruby
-installation. See the table below:</p>
+there is a special Windows installer which takes care of the Ruby-
+and Tcl/Tk requirements. See the table below:</p>
<table id="prereq">
@@ -162,17 +157,17 @@ installation. See the table below:</p>
better off installing the TeX Live package, which also gives you
wrappers for epspdf and epspdftk for use on the command-line and
for on-the-fly conversions. You still need to
- install Ruby 1.8 and Tcl/Tk.</td></tr>
+ install Ruby and Tcl/Tk.</td></tr>
</tfoot>
<tr><th class="fcol">TeX Live<a href="#tlnote">(1)</a></th><td>No additional
requirements</td> <td>Ruby, Tcl/Tk<a href="#tlzipnote">(2)</a></td></tr>
<tr><th class="fcol">MiKTeX</th><td>Pdftops (optional)</td> <td>Pdftops
- (optional); Ruby 1.8, Tcl/Tk(optional)</td></tr>
+ (optional); Ruby, Tcl/Tk(optional)</td></tr>
<tr><th class="fcol">Other/None</th><td>Ghostscript, pdftops (optional)</td>
- <td>Ghostscript; pdftops(optional), Ruby 1.8, Tcl/Tk
+ <td>Ghostscript; pdftops(optional), Ruby, Tcl/Tk
(optional)</td></tr>
</table>
@@ -214,39 +209,19 @@ installation. See the table below:</p>
<dt>Ruby one-click installer for 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>
+ http://rubyforge.org/projects/rubyinstaller/</a>)</dt>
<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>Tcl Developer Xchange (<a href="http://www.tcl.tk/">http://www.tcl.tk/</a>)</dt>
+
<dt>ActiveTcl from ActiveState (<a
href="http://activestate.com/Products/ActiveTcl/">
- http://activestate.com/Products/ActiveTcl/</a></dt> <dd>
- Version 8.4 is the safer bet.</dd>
+ http://activestate.com/Products/ActiveTcl/</a></dt>
</dl>
-<h3><a name="rubytk">Ruby's Tk interface library</a></h3>
-
-<p>At the moment, the Ruby Tk interface is not as readily available
- as it has been: at some time during the 8.4 cycle, the Windows
- Ruby one-click installer dropped Tcl/Tk, and aimed instead to hook
- up to any already-installed Tcl/Tk. As to Ruby 1.9: at the moment
- I know of no easy-to-use installer on Windows which includes a Tk
- interface library. On Mac OS X 10.6 (Snow Leopard) the Ruby Tk
- interface library also went missing, although both Ruby and Tcl/Tk
- are still included.</p>
-<p>I am working on a pure Tcl/Tk interface, <i>i.e.</i>a Tcl/Tk
- script which calls epspdf as a program, not as a library, but I
- can give no ETA. This will eliminate dependence on a Ruby/Tk
- interface library.</p>
<h2><a name="install"/>Installation</h2>
@@ -258,37 +233,43 @@ installation. See the table below:</p>
<h3>Windows setup program</h3>
-<p>Download the <a href="epspdf.0.4.3.exe">epspdftk setup
+<p>Download the <a href="epspdf.0.5.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>
+<p>The setup program has been created
+with <a href="http://nsis.sourceforge.net/">NSIS</a></p>.
+
<h3>Windows zipfile</h3>
-<p>Download the <a href="epspdf.0.4.3.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>
+<p>Download the <a href="epspdf.0.5.zip">epspdf zip file</a>,
+unpack it somewhere and create a batchfile epspdf.bat such as</p>
<pre>
-"&lt;path_to_ruby.exe&gt;" "&lt;path_to_epspdf.rb&gt;" %*
+ruby "&lt;path_to_epspdf.rb&gt;" %*
</pre>
-<p>Similarly for epspdftk. With such a batchfile, the caller has to
-take care of quoting:</p>
+<p>for epspdf.rb, and a batchfile epspdftk.bat</p>
+
<pre>
-epspdf "my file.eps" "my file.pdf"
+wish85 "&lt;path_to_epspdftk.tcl&gt;" %1
</pre>
+<p>for epspdftk.tcl. The wish executable might also be named
+ wish[.exe] or wish84[.exe]. The first command-line parameter will
+ be interpreted as startup directory for the file browser. Make
+ sure that wish85, ruby and these batchfiles are on your
+ searchpath.</p>
+
<p>Epspdf[tk] has been tested with Windows 2000, Windows XP and
Windows 7.</p>
<h3>Unix/Linux</h3>
-<p>Download the <a href="epspdf.0.4.3.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 create a shell script
+<p>Download the <a href="epspdf.0.5.tgz">tar.gz archive</a> and
+unpack it in some directory. If you plan to use epspdf.rb from the
+command-line, create a shell script
<tt>epspdf</tt> such as</p>
<pre>
@@ -304,16 +285,10 @@ browser.</p>
<h3>Mac OS X</h3>
-<p>You can install as for Unix/Linux. Here, too, all files should be
-in the same directory.</p>
-
-<p>There is also a compressed disk image epspdf.x.x.x.dmg.gz which
-wraps epspdftk into a Max OS X <q>app</q>. Double-click once to
-expand, a second time to mount, then drag epspdftk.app to the
-Applications folder. The current version has been created and tested
-with Leopard. As pointed out <a href="#rubytk">above</a>, under Snow
-Leopard the GUI program epspdftk will not work without a third-party
-Ruby/Tk.</p>
+<p>Although you can install as for Unix/Linux, there is also a
+compressed disk image epspdf.x.x.x.dmg.gz which wraps epspdftk into
+a Max OS X <q>app</q>. Double-click once to expand, a second time to
+mount, then drag epspdftk.app to the Applications folder.</p>
<p>Epspdf mostly duplicates functionality of Preview. But having an
alternate conversion engine means that you can have another shot at
@@ -324,42 +299,48 @@ problem files.</p>
<h3>Windows</h3>
<p>Epspdftk will use the default Windows programs for PostScript and
-pdf. If you have TeX Live 2008 or later then you can assign &lt;TeX
-Live root&gt;\bin\win32\psv.bat as previewer for .ps- and .eps
-files. For Windows only, there is an additional <q>View
-with...</q> button to select a viewer yourself.</p>
+pdf.</p>
<h3>Unix/Linux</h3>
-<p>Supported PostScript viewers include evince, gv, gsview and
+<p>Supported PostScript viewers include evince, gv and
okular. These are also listed as pdf viewers. Additional pdf viewers
-are xpdf, gpdf, epdfview and acroread/Adobe Reader. You can also
+are xpdf, kpdf, epdfview and acroread/Adobe Reader. You can also
specify a previewer manually in the configuration screen; see the <a
href="epspdf.pdf"> user manual.</a>.</p>
<h3>Mac OS X</h3>
-<p>Epspdftk will always use the default pdf viewer under OS X,
-usually Preview or Adobe Reader.</p>
+<p>Epspdftk uses the default pdf viewer under OS X, usually Preview
+or Adobe Reader.</p>
<h2><a name="files"/>Files</h2>
<ul>
-<li><a href="epspdf.0.4.3.tgz">epspdf.0.4.3.tgz</a> preferred for Unix
-and Mac OS X; GUI fails under OS X Snow Leopard with built-in Ruby</li>
+<li><a href="epspdf.0.5.tgz">epspdf.0.5.tgz</a> preferred for Unix
+and Mac OS X</li>
-<li><a href="epspdf.0.4.3.zip">epspdf.0.4.3.zip</a> preferred for
-Windows</li>
+<li><a href="epspdf.0.5.zip">epspdf.0.5.zip</a> preferred for
+Windows if you don't want to use the installer below</li>
-<li><a href="epspdf.0.4.3.exe">epspdf.0.4.3.exe</a> Windows setup
- program, including Ruby/Tk subset</li>
+<li><a href="epspdf.0.5.exe">epspdf.0.5.exe</a> Windows setup
+ program, including Ruby subset. The epspdftk script has been
+ packaged with a basic Tcl/Tk into a single exe file (starpack).</li>
-<li><a href="epspdftk.0.4.3.dmg.gz">epspdftk.0.4.3.dmg.gz</a>;
- built and tested on Leopard</li>
+<li><a href="epspdftk.0.5.dmg.gz">epspdftk.0.5.dmg.gz</a>
+ compressed disk image with epspdftk wrapped into a Mac OS X <q>app</q></li>
</ul>
<h3>Older releases</h3>
<ul>
+<li><a href="http://tex.aanhet.net/epspdf/epspdftk.0.4.3.dmg.gz">epspdftk.0.4.3.dmg.gz</a>;
+ GUI doesn't work on Snow Leopard</li>
+<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.4.3.tgz">epspdf.0.4.3.tgz</a>
+for Unix and Mac OS X</li>
+<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.4.3.zip">epspdf.0.4.3.zip</a>
+for Windows</li>
+<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.4.3.exe">epspdf.0.4.3.exe</a>
+Windows setup program</li>
<li><a href="http://tex.aanhet.net/epspdf/epspdftk.0.4.2.dmg.gz">epspdftk.0.4.2.dmg.gz</a>;
tested on Tiger and Leopard</li>
<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz">epspdf.0.3.0.tgz</a>
@@ -387,9 +368,12 @@ Mac OS X applet for starting epspdftk.rb</li>
<h2><a name="releases"/>Releases</h2>
-<dl><dt>0.4.3</dt><dd>Current version. Fixes for compatibility with
- Ruby 1.9 and, under Windows, for newer Ghostscript
- versions. Documentation updates.</dd>
+<dl><dt>0.5</dt><dd>Current version. Ruby/Tk GUI replaced with
+ Tcl/Tk GUI. Starpack wrapper for Windows setup version.</dd>
+
+<dt>0.4.3</dt><dd>Fixes for compatibility with Ruby 1.9 and, under
+ Windows, for newer Ghostscript versions. Documentation
+ updates.</dd>
<dt>0.4.2</dt><dd>More liberal documentation
license. Slight documentation updates.</dd>
@@ -443,5 +427,5 @@ Mac OS X applet for starting epspdftk.rb</li>
<hr/>
-<p class="fineprint">Last revised: Januari 27, 2010</p>
+<p class="fineprint">Last revised: March 29, 2010</p>
</body></html>