From e2f24386f207b8ca102a8a3535dd91ed99d7a7e1 Mon Sep 17 00:00:00 2001 From: Siep Kroonenberg Date: Mon, 29 Mar 2010 10:43:59 +0000 Subject: Epspdf rev. 0.5, documentation git-svn-id: svn://tug.org/texlive/trunk@17605 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/support/epspdf/Changelog | 17 ++ Master/texmf-dist/doc/support/epspdf/README | 16 +- Master/texmf-dist/doc/support/epspdf/README.tl | 5 +- Master/texmf-dist/doc/support/epspdf/default.css | 20 +- .../texmf-dist/doc/support/epspdf/epspdf.install | 320 ++++++++++----------- Master/texmf-dist/doc/support/epspdf/epspdf.pdf | Bin 251976 -> 261092 bytes Master/texmf-dist/doc/support/epspdf/epspdf.texi | 192 ++++++++----- .../doc/support/epspdf/images/cnv_osx.png | Bin 32216 -> 42762 bytes .../doc/support/epspdf/images/config_lnx.png | Bin 14765 -> 6671 bytes .../doc/support/epspdf/images/epspdf.png | Bin 0 -> 4126 bytes .../texmf-dist/doc/support/epspdf/images/logo.pdf | Bin 0 -> 4090 bytes .../doc/support/epspdf/images/main_w32.png | Bin 7274 -> 10094 bytes Master/texmf-dist/doc/support/epspdf/index.html | 210 +++++++------- 13 files changed, 414 insertions(+), 366 deletions(-) create mode 100644 Master/texmf-dist/doc/support/epspdf/images/epspdf.png create mode 100644 Master/texmf-dist/doc/support/epspdf/images/logo.pdf (limited to 'Master/texmf-dist/doc/support/epspdf') 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 "" %* - "" "" %* + for epspdf.rb, and a batchfile epspdftk.bat - Similarly for epspdftk. With such a batchfile, the caller has to take care - of quoting: + wish85 "" %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 /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 \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 Binary files a/Master/texmf-dist/doc/support/epspdf/epspdf.pdf and b/Master/texmf-dist/doc/support/epspdf/epspdf.pdf 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 Binary files a/Master/texmf-dist/doc/support/epspdf/images/cnv_osx.png and b/Master/texmf-dist/doc/support/epspdf/images/cnv_osx.png 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 Binary files a/Master/texmf-dist/doc/support/epspdf/images/config_lnx.png and b/Master/texmf-dist/doc/support/epspdf/images/config_lnx.png 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 Binary files /dev/null and b/Master/texmf-dist/doc/support/epspdf/images/epspdf.png 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 Binary files /dev/null and b/Master/texmf-dist/doc/support/epspdf/images/logo.pdf 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 Binary files a/Master/texmf-dist/doc/support/epspdf/images/main_w32.png and b/Master/texmf-dist/doc/support/epspdf/images/main_w32.png 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 @@ -

Epspdf and epspdftk

+ + + +

Current online version of this page

@@ -28,7 +34,6 @@ this page

@@ -101,47 +112,31 @@ checked for when epspdf starts:

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.

+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.

-

Mac OS X (Tiger and Leopard)

+

Mac OS X

-

Ruby, Tcl/Tk and Ruby/Tk are already part of Tiger and - Leopard.

+

Note. Version 0.5 has not been tested with Tiger.

-

Ghostscript is included in MacTeX, but is also available via -e.g. MacPorts.

+

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 http://users.phg-online.de/tk/MOSXS/.

-

You can get pdftops from MacPorts as part of either Poppler or -xpdf. Another source -is 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 +

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.

-

Mac OS X Snow Leopard

- -

For Ghostscript and pdftops, see above.

- -

Unfortunately, in Snow Leopard Ruby's Tk bindings went missing, - so the GUI interface won't work with the built-in Ruby; - see below. If you compile Ruby yourself - from source - you get the Tk interface automatically. Call configure - with a --enable-pthread option.

- -

Snow Leopard's built-in Ruby is fine for command-line use and - on-the-fly conversions.

-

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:

+there is a special Windows installer which takes care of the Ruby- +and Tcl/Tk requirements. See the table below:

@@ -162,17 +157,17 @@ installation. See the table below:

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. + install Ruby and Tcl/Tk. + (optional); Ruby, Tcl/Tk(optional) -
TeX Live(1)No additional requirements Ruby, Tcl/Tk(2)
MiKTeXPdftops (optional) Pdftops - (optional); Ruby 1.8, Tcl/Tk(optional)
Other/NoneGhostscript, pdftops (optional)Ghostscript; pdftops(optional), Ruby 1.8, Tcl/Tk + Ghostscript; pdftops(optional), Ruby, Tcl/Tk (optional)
@@ -214,39 +209,19 @@ installation. See the table below:

Ruby one-click installer for Windows ( - http://rubyforge.org/projects/rubyinstaller/)
Current - versions (1.8.4 and later) require Tcl/Tk to be separately - installed.
- -
Old releases of Ruby one-click installer ( - http://rubyforge.org/frs/?group_id=167)
Versions - prior to 1.8.4 include Tcl/Tk.
+ http://rubyforge.org/projects/rubyinstaller/)
Ruby source code (http://www.ruby-lang.org/en/downloads/)
For those people who prefer to roll their own...
+
Tcl Developer Xchange (http://www.tcl.tk/)
+
ActiveTcl from ActiveState ( - http://activestate.com/Products/ActiveTcl/
- Version 8.4 is the safer bet.
+ http://activestate.com/Products/ActiveTcl/ -

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.

-

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.

Installation

@@ -258,37 +233,43 @@ installation. See the table below:

Windows setup program

-

Download the epspdftk setup +

Download the 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 NSIS

. +

Windows zipfile

-

Download the 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 epspdf zip file, +unpack it somewhere and create a batchfile epspdf.bat such as

-"<path_to_ruby.exe>" "<path_to_epspdf.rb>" %*
+ruby "<path_to_epspdf.rb>" %*
 
-

Similarly for epspdftk. With such a batchfile, the caller has to -take care of quoting:

+

for epspdf.rb, and a batchfile epspdftk.bat

+
-epspdf "my file.eps" "my file.pdf"
+wish85 "<path_to_epspdftk.tcl>" %1
 
+

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 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 +

Download the 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

@@ -304,16 +285,10 @@ browser.

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 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 @@ -324,42 +299,48 @@ problem files.

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.

+pdf.

Unix/Linux

-

Supported PostScript viewers include evince, gv, gsview and +

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 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

Older releases