summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/epspdf/index.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/support/epspdf/index.html')
-rw-r--r--Master/texmf-dist/doc/support/epspdf/index.html386
1 files changed, 83 insertions, 303 deletions
diff --git a/Master/texmf-dist/doc/support/epspdf/index.html b/Master/texmf-dist/doc/support/epspdf/index.html
index 5e8cd48eb9e..7c6d18d0d15 100644
--- a/Master/texmf-dist/doc/support/epspdf/index.html
+++ b/Master/texmf-dist/doc/support/epspdf/index.html
@@ -31,16 +31,17 @@ dot nl</tt></i></p>
<p><a href="http://tex.aanhet.net/epspdf/">Current online version of
this page</a></p>
+<p><a href="http://tex.aanhet.net/epspdf/legacy.html">Legacy
+Ruby-based versions</a></p>
+
<h2>Table of Contents</h2>
<ul>
<li><a href="#features">Features</a></li>
<li><a href="#prerequisites">Prerequisites</a></li>
<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="#releases">Releases</a></li>
-<li><a href="epspdf.pdf">User Manual</a></li>
</ul>
<h2><a name="features"/>Features</h2>
@@ -52,11 +53,10 @@ this page</a></p>
<li>Also converts from pdf back to PostScript and eps</li>
<li>Removal of preview headers from eps files</li>
<li>Cropping extra whitespace</li>
-<li>Grayscaling (sometimes)</li>
+<li>Grayscaling</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 and Unix/Linux</li>
<li>Support for TeX Live and MiKTeX</li>
</ul>
@@ -72,23 +72,24 @@ GUI.</p>
<p>Epspdftk adds a GUI, with buttons to select options and with
dialogs for opening and saving files.</p>
-<p>A lot more can be done if you can round-trip between PostScript
-and pdf. Although Ghostscript can go from pdf to PostScript, pdftops
-does a much better job converting text back to PostScript. This
-opens several new possibilities: grayscaling and computing a better
-boundingbox for either eps- or pdf graphics, and page selection from
-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>A lot more can be done with multistep conversions: grayscaling,
+page selection, computing a tight boundingbox. People who depend on
+PSTricks will appreciate the option to go from pdf to
+PostScript.</p>
+
+<p>Where it makes sense, epspdf uses additional software for a
+better outcome.</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>The command-line program epspdf is written in texlua, which is
+already part of recent versions of MikTeX and TeX Live. Versions <a
+href="http://tex.aanhet.net/epspdf/legacy.html">prior to 0.6</a>
+were written in Ruby. Epspdftk, its GUI companion, is written in in
+Tcl/Tk.</p>
-<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>Starting with the 2008 edition, TeX Live includes epspdf in some
+form 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
@@ -100,159 +101,75 @@ ado.</p>
<p>These are the required and optional prerequisites, which will be
checked for when epspdf starts:</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> or 1.9.<i>x</i></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>
-
-<p>You may not have to install all of these yourself.</p>
-
-<h3>Linux</h3>
-
-<p>On a current Linux distribution you can almost certainly install
-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</h3>
-
-<p><b>Note.</b> Version 0.5.x has not been tested with Tiger.</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>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>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 takes care of the Ruby-
-and Tcl/Tk requirements. See the table below:</p>
-
-<table id="prereq">
-
- <thead><tr><th class="fcol">TeX
- distribution</th><th>Installer</th><th>Zipfile</th></tr></thead>
-
- <tfoot>
- <tr><td colspan="3"><b><a name="tlnote"
- class="fineprint"> (1)</a></b> MikTeX and TeX Live &ge; 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 impossible to install an
- older TeX Live without Ghostscript, in which case you have to
- provide a Ghostscript yourself.</td></tr>
-
- <tr><td colspan="3"><b><a name="tlzipnote"
- class="fineprint"> (2)</a></b> With TeX Live &ge; 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 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, Tcl/Tk(optional)</td></tr>
-
- <tr><th class="fcol">Other/None</th><td>Ghostscript, pdftops (optional)</td>
- <td>Ghostscript; pdftops(optional), Ruby, Tcl/Tk
- (optional)</td></tr>
-
-</table>
-
-<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 &ge; 2008 includes pdftops, Ghostscript and
- optionally epspdf.</dd>
+<li>A recent TeX installation, either <a
+ href="http://www.tug.org/texlive/">TeX Live</a> or <a
+ href="http://miktex.org/">MikTeX</a>. If this is not an option,
+ get a <a href="http://tex.aanhet.net/epspdf/legacy.html">legacy
+ version</a> of epspdf instead.</li>
-<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>
+<li><a href="http://ghostscript.com">Ghostscript</a></li>
-<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>
+<li>Optional: pdftops from the <a
+ href="http://www.foolabs.com/xpdf/">xpdf suite</a> or from the <a
+ href="http://poppler.freedesktop.org/">Poppler
+ utilities</a>. Pdftops may do a better job of preserving scalable
+ fonts when converting from pdf to ps.</li>
-<dt>Ruby one-click installer for Windows (<a
- href="http://rubyforge.org/projects/rubyinstaller/">
- http://rubyforge.org/projects/rubyinstaller/</a>)</dt>
+<li><a href="http://www.tcl.tk/">Tcl/Tk</a> for the GUI
+ interface. Versions 8.4 and 8.5 have been tested. A single-file <a
+ href="http://wiki.tcl.tk/52">TclKit</a> runtime is
+ sufficient. Recent <a
+ href="http://www.patthoyts.tk/tclkit/win32-ix86/">Windows
+ precompiled tclkit binaries</a> are available.</li>
-<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>
+<li>Optional: viewers for PostScript and pdf</li>
-<dt>Tcl Developer Xchange (<a href="http://www.tcl.tk/">http://www.tcl.tk/</a>)</dt>
+</ul>
-<dt>ActiveTcl from ActiveState (<a
- href="http://activestate.com/Products/ActiveTcl/">
- http://activestate.com/Products/ActiveTcl/</a></dt>
-</dl>
+<p>On Windows, both MikTeX and TeX Live already include a copy of
+Ghostscript. TeX Live for Windows also includes pdftops.</p>
+<p>If you have MiKTeX and a copy of pdftops.exe, then you can point
+epspdf to this file from within the GUI. You need to do this only
+once.</p>
<h2><a name="install"/>Installation</h2>
-<p>First make sure that the prerequisites are met. Then:</p>
+<p>If you have a sufficiently recent standalone TeX Live, just
+ install the package. Otherwise:</p>
-<h3>TeX Live &ge; 2008</h3>
+<h3>Unix/Linux</h3>
-<p>Use TeX Live's package manager tlmgr for installation.</p>
+<p>Unpack the archive somewhere and create symlinks to epspdf.tlu
+ and epspdftk.tcl in a directory on your searchpath.</p>
<h3>Windows setup program</h3>
-<p>Download the <a href="epspdf.0.5.3.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>This is a conventional Windows installer. If it does not find
+texlua.exe on the searchpath then it gives a warning and a chance to
+abort. It creates a shortcut to the epspdftk GUI and it also creates
+an uninstaller.</p>
+
+<p>It installs epspdftk in the form of a so-called
+<em>starpack</em>, which
+consists of the epspdftk script and a Tcl/Tk runtime, wrapped into
+a single file. The command-line script epspdf.tlu remains a separate
+file.</p>
-<p>The setup program has been created
-with <a href="http://nsis.sourceforge.net/">NSIS</a>.</p>
+<p>This installer has been created with <a
+href="http://nsis.sourceforge.net/">NSIS</a>.</p>
<h3>Windows zipfile</h3>
-<p>Download the <a href="epspdf.0.5.3.zip">epspdf zip file</a>,
-unpack it somewhere and create a batchfile epspdf.bat such as</p>
+<p>Download the epspdf zip file, unpack it somewhere and create a
+batchfile epspdf.bat such as</p>
<pre>
-ruby "&lt;path_to_epspdf.rb&gt;" %*
+texlua "&lt;path_to_epspdf.tlu&gt;" %*
</pre>
-<p>for epspdf.rb, and a batchfile epspdftk.bat</p>
+<p>for epspdf.tlu, and a batchfile epspdftk.bat</p>
<pre>
wish85 "&lt;path_to_epspdftk.tcl&gt;" %1
@@ -261,176 +178,39 @@ wish85 "&lt;path_to_epspdftk.tcl&gt;" %1
<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.5.3.tgz">tar.gz archive</a> and
-unpack it in some directory. If you plan to use epspdf.rb from the
-command-line, create a symlink to <tt>epspdf.rb</tt> somewhere on
-your searchpath.</p>
-
-<p>You can do the same for epspdftk. The first command-line
-parameter will be interpreted as startup directory for the file
-browser.</p>
-
-<h3>Mac OS X</h3>
-
-<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
-problem files.</p>
-
-<h2><a name="preview"/>Preview programs</h2>
+ sure that wish85 and these batchfiles are on your searchpath.</p>
-<h3>Windows</h3>
-
-<p>Epspdftk will use the default Windows programs for PostScript and
-pdf.</p>
-
-<h3>Unix/Linux</h3>
-
-<p>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 <a
-href="epspdf.pdf"> user manual.</a>.</p>
-
-<h3>Mac OS X</h3>
-
-<p>Epspdftk uses the default pdf viewer under OS X, usually Preview
-or Adobe Reader.</p>
+<p>Epspdf[tk] has been tested with Windows XP, Windows 7 and
+Windows 8.</p>
<h2><a name="files"/>Files</h2>
<ul>
-<li><a href="epspdf.0.5.3.tgz">epspdf.0.5.3.tgz</a> preferred for Unix
+
+ <li><a href="epspdf.0.6.03.tgz">epspdf.0.6.0.tgz</a> preferred for Unix
and Mac OS X</li>
-<li><a href="epspdf.0.5.3.zip">epspdf.0.5.3.zip</a> preferred for
+<li><a href="epspdf.0.6.0.zip">epspdf.0.6.0.zip</a> preferred for
Windows if you don't want to use the installer below</li>
-<li><a href="epspdf.0.5.3.exe">epspdf.0.5.3.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="epspdf.0.6.0.exe">epspdf.0.6.0.exe</a> Windows setup
+ program which installs epspdf with a buit-in Tcl/Tk runtime.</li>
-<li><a href="epspdftk.0.5.3.dmg.gz">epspdftk.0.5.3.dmg.gz</a>
- compressed disk image with epspdftk wrapped into a Mac OS X <q>app</q></li>
</ul>
-<h3>Older releases</h3>
+<h2><a name="releases"/>Releases</h2>
+
<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>
-for Unix and Mac OS X</li>
-<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip">epspdf.0.3.0.zip</a>
-for Windows</li>
-<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe">epspdf.0.3.0.exe</a>
-Windows setup program</li>
-<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz">epspdf.0.2.12.tgz</a>
-for Unix, including Mac OS X</li>
-<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip">epspdf.0.2.12.zip</a>
-for Windows</li>
-<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe">epspdf.0.2.12.exe</a>
-Windows setup program</li>
-<li><a href="http:/tex.aanhet.net/epspdf/epspdf.0.2.01.tgz">epspdf.0.2.01.tgz</a>
-for Unix
- and Mac OS X</li>
-<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip">epspdf.0.2.01.zip</a>
-for Windows</li>
-<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.2.exe">epspdf.0.2.exe</a>,
-Windows setup program</li>
-<li><a href="http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip">epspdf_app.0.2.01.zip</a>
-Mac OS X applet for starting epspdftk.rb</li>
-</ul>
-<h2><a name="releases"/>Releases</h2>
+<li>0.6.0 Current version. Command-line component
+rewritten in texlua.</li>
+
+<li><a href="http://tex.aanhet.net/epspdf/legacy.html">Legacy
+Ruby-based versions</a></li>
-<dl><dt>0.5.3</dt><dd>Current version. Minor initialization fix for
- Windows. The AppleScript wrapper for Mac OS X no longer starts a
- terminal. For users of Linux/Unix, there is no reason to
- upgrade.</dd>
-
-<dt>0.5.2</dt><dd>Under Unix, wrapper scripts can now be replaced
- with simple symlinks.</dd>
-
-<dt>0.5.1</dt><dd>Bug fix for boundingbox atend.</dd>
-
-<dt>0.5</dt><dd>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>
-
-<dt>0.4.1</dt><dd>Documentation: added section on
- bitmaps. Windows setup program: added missing Tcl/Tk
- licenses. Mac: double-clickable epspdftk.app with included
- epspdftk replaces double-clickable epspdf.app add-on.</dd>
-
-<dt>0.4.0</dt><dd>Optionally uses hires boundingbox. Faster startup
- due to simpler testing of prerequisites. Grayscaling: support for
- HSB color model, although I yet have to encounter a PostScript
- file using this. Manual converted to texinfo format. Windows: new
- <q>View with...</q> button; support for MikTeX's built-in
- Ghostscript; streamlined Ruby subset, with Tcl/Tk compiled from
- source.</dd>
-
-<dt>0.3.0</dt><dd>Under Windows, now recognizes whether it is
- embedded in TeX Live 2008 and then can use 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 changes in user
- guide.</dd>
-
-<dt>0.2.11</dt><dd> Minor fixes. Changes in documentation.</dd>
-
-<dt>0.2.10</dt><dd>A computed boundingbox is now expanded by one
- point in all directions. This should prevent too-tight
- cropping. There is no interface for changing this amount; it can
- only be changed by hand-editing the bb_spread option in the
- .epspdfrc file or in the HKCU\software\epspdf registry key.</dd>
- <dd>The File Open dialog remembers the last directory visited
- (between calls, not between program 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. 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>
+</ul>
<hr/>
-<p class="fineprint">Last revised: February 27, 2011</p>
+<p class="fineprint">Last revised: February 7, 2013</p>
</body></html>