Updates to epspdf manual

git-svn-id: svn://tug.org/texlive/trunk@49952 c570f23f-e606-0410-a88d-b1316a301751

4 files changed, 167 insertions, 109 deletions

diff --git a/Master/texmf-dist/doc/support/epspdf/Changelog b/Master/texmf-dist/doc/support/epspdf/Changelog
index ed45ae68818..cf31923aec1 100644
--- a/Master/texmf-dist/doc/support/epspdf/Changelog
+++ b/Master/texmf-dist/doc/support/epspdf/Changelog
@@ -1,3 +1,29 @@
+2019-02-01 0.6.4
+
+	pdf_crop: epdf replaced by pdfe if available (LuaTeX >= 1.9)
+
+	Better handling of pdfs with negative coordinates in MediaBox and
+	some corner cases
+
+	Ghostscript: support for later versions of pdf format
+
+	Eps files with large boundingbox coordinates: added a -r300
+	resolution parameter when asking Ghostscript to calculate their
+	boundingbox. Hopefully, this prevents grossly inaccurate results.
+
+	Pdftops on Windows: always use pdftops from searchpath
+
+	Some refactoring
+
+	epspdftk: no more black console windows under windows
+
+	epspdftk: use of ttk widgets; no more support for Tk versions
+	prior to 8.5.
+
+	epspdftk: updated selection of viewers under `plain unix'
+
+	Updates to the manual
+
 2016-05-06 0.6.3
 
 	Pdf page selection and cropping: simplified and updated the
diff --git a/Master/texmf-dist/doc/support/epspdf/README b/Master/texmf-dist/doc/support/epspdf/README
index ef20085fb4b..9869ec09410 100644
--- a/Master/texmf-dist/doc/support/epspdf/README
+++ b/Master/texmf-dist/doc/support/epspdf/README
@@ -3,10 +3,15 @@ command-line backend, can be used by itself.
 
 Both are scripts: epspdf.tlu is written in texlua and uses the
 texlua script interpreter from TeX Live or MiKTeX. Epspdftk.tcl
-requires Tcl/Tk, either a full installation or a tclkit runtime.
+requires Tcl/Tk, either a full installation or a tclkit runtime. TeX
+Live already includes a tclkit runtime for Windows.
+
+Epspdftk.tcl can find the other files as long are they are all in
+the same directory. epspdf4tk.cmd is needed only when running
+epspdftk.tcl under Windows.
 
 Full documentation is available in the doc subdirectory.
 
-Windows users: you may prefer the epspdf-setup package, which
-installs a version of epspdftk which requires no additional software
-beyond MiKTeX or TeX Live.
+Windows MiKTeX users: you may prefer the epspdf-setup package, which
+installs a version of epspdftk which includes a regular installer
+and requires no software beyond MiKTeX.
diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.pdf b/Master/texmf-dist/doc/support/epspdf/epspdf.pdf
index b4dc5fa6725..92ff2e1311f 100644
--- a/Master/texmf-dist/doc/support/epspdf/epspdf.pdf
+++ b/Master/texmf-dist/doc/support/epspdf/epspdf.pdf
diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.texi b/Master/texmf-dist/doc/support/epspdf/epspdf.texi
index debfd8f39cd..1c87952cae8 100644
--- a/Master/texmf-dist/doc/support/epspdf/epspdf.texi
+++ b/Master/texmf-dist/doc/support/epspdf/epspdf.texi
@@ -29,16 +29,15 @@
 @hyphenation{epspdf-tk epspdf}
 @end iftex
 
-@set version 0.6.3
-@set homepage http://tex.aanhet.net/epspdf/
+@set version 0.6.4
 
 @setchapternewpage off
 @paragraphindent none
 
 @copying
-This manual is for epspdf, version @value{version}.
+This manual is for epspdf and epspdftk, version @value{version}.
 
-Copyright @copyright{} 2006, 2008, 2009, 2010, 2011, 2013, 2014, 2015, 2016 Siep Kroonenberg.
+Copyright @copyright{} 2006-2019 Siep Kroonenberg.
 
 @quotation
 Copying and distribution of this file, with or without modification,
@@ -58,7 +57,7 @@ without any warranty.
 @sp 1
 @center A cross-platform GUI- and command-line converter for [e]ps and pdf
 @sp 2
-@center Siep Kroonenberg (@email{n dot s dot kroonenberg at rug dot nl})
+@center Siep Kroonenberg (@email{siepo at bitmuis dot nl})
 @vskip 0pt plus 1filll
 @insertcopying
 @end titlepage
@@ -78,6 +77,7 @@ without any warranty.
 * Notes on PostScript and pdf::
 * Bitmapped graphics for @LaTeX{} and pdflatex::
 * Troubleshooting::
+* Requirements::
 * Change history::
 
 @detailmenu
@@ -107,7 +107,7 @@ Notes on PostScript and pdf
 Bitmapped graphics for @LaTeX{} and pdflatex
 
 * Linux::
-* Mac OS X::
+* Mac OS::
 * Windows::
 
 Troubleshooting
@@ -122,6 +122,7 @@ Troubleshooting
 
 Change history
 
+* Version 6.4::
 * Version 0.6::
 * Version 0.5::
 * Version 0.4::
@@ -143,29 +144,28 @@ Change history
 @node Overview, Viewing, Usage, Usage
 @section Overview
 
-Epspdftk converts files between eps, pdf and general
-PostScript. The main screen lets you open a file, select some options
-and convert the file.
+Epspdftk is a GUI program that converts files between eps, pdf and
+general PostScript in any direction.
 
-When opening a file, epspdf tries to find out file type and, in
-the case of a pdf file, the number of pages. This information is
-displayed in the box in the upper part of the screen.
+It lets you interactively select a file, set conversion options, and
+save in the same of another format. A configuration screen offers
+some additional conversion options.
 
 @ifnotinfo
-@noindent @image{images/main_w8,,3in}
+@noindent @image{images/main_wx,,2.9in}
 @iftex
 @hfill
 @end iftex
-@image{images/cnv_linux,,3in}
+@image{images/cnv_linux,,2.9in}
 @end ifnotinfo
 
 @node Viewing, Conversion options, Overview, Usage
 @section Viewing
 
-The View button at the bottom of the screen calls an
+The View button at the bottom of the screen invokes an
 external viewer.
 
-@i{Windows and OS X:} Epspdftk simply tries to use the default Open
+@i{Windows and Mac OS:} Epspdftk simply tries to use the default Open
 command.
 
 Under Linux the PostScript- and pdf viewers are
@@ -177,20 +177,25 @@ previewer for the current file.
 @node Conversion options, Converting, Viewing, Usage
 @section Conversion options
 
-@anchor{gray}@i{Grayscaling:} Grayscaling is now done by Ghostscript
-itself and should ``just work''.
+@itemize
+@item
+@anchor{gray}Grayscaling
 
-@i{Compute tight boundingbox:} This option is only available
+@item
+Compute tight boundingbox. This option is only available
 if a single page is converted.
 
-@i{Page selection:} The only possibilities are selecting a single page
+@item
+Page selection. The only possibilities are selecting a single page
 or selecting all pages. Converting to eps implies selecting a single
 page.
+@end itemize
 
-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.
+@i{Note.} 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
+anyway.
 
 Specifying options such as grayscaling or page selection may require
 a multistep conversion.
@@ -198,9 +203,10 @@ a multistep conversion.
 @node Converting, The configuration screen, Conversion options, Usage
 @section Converting
 
-The Convert and save... button calls up a file save dialog. After a
+The Convert and save@dots{} 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.
+can judge the result by pressing the View button again -- if epspdftk
+thinks that there is a suitable viewer.
 
 @node The configuration screen,  , Converting, Usage
 @section The configuration screen
@@ -219,7 +225,7 @@ in this screen. Epspdf looks for a number of PostScript- and pdf
 viewers, from which you can select one, but you can also enter one
 manually.
 
-For Windows and Mac OS X, there is no such configuration option. Epspdf
+For Windows and Mac OS there is no such configuration option. Epspdf
 will use the program associated with the file type, which can be
 configured outside epspdf.
 
@@ -227,35 +233,28 @@ configured outside epspdf.
 Double-check the setting ``Target use'' under ``Conversion to
 pdf''. ``prepress'' is for pdfs which are going to be printed
 commercially. The options prepress, printer and default will try to
-embed all fonts. Often, printshops insist on this. With luck,
-Ghostscript fonts and system fonts will be used for fonts which were not
-originally embedded. Note that ``printer'' may not work with some
-versions of Ghostscript, due to a bug in the handling of color.
+embed all fonts. Often, printshops insist on this.
 
 On the other hand, you may prefer ``screen'' if file size is a
 concern. See also the Ghostscript documentation, in particular Use.htm
-and Ps2pdf.htm.
+and VectorDevices.htm.
 
 Specifying anything other than ``default'' may cause an additional
 conversion step and possibly also loss of high-level structure.
 
 As to pdf versions: this is a trade-off between more features for higher
-versions and better compatibility for lower versions -- although even
-version 1.4 is far from bleeding-edge. Converting to a
-lower version may lead to rasterization of vector data and (much) larger
-file sizes. For prepress use, the printshop or publisher may require a
-low version number but otherwise leave this at ``default''.
+versions and better compatibility for lower versions. Versions below 1.4
+do not support transparency. Converting a page or graphic with
+transparencies to version 1.3 will probably result in the whole page or
+graphic getting rasterized. For prepress use, consult your printshop or
+publisher. Otherwise leave the pdf version at ``default''.
 
 @subsection Options for converting to PostScript
-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. With older Ghostscript versions, characters may be
-converted to drawn shapes or little bitmaps, so use pdftops if
-available. With newer Ghostscript versions, with an eps2write rather
-than an epswrite output device, Ghostscript does a much better job.
-
-Under an older MikTeX without bundled pdftops, this is also the place to
-point the program to the location of pdftops.exe.
+For conversion to plain or Encapsulated PostScript, pdftops sometimes
+does a better job of preserving fonts than Ghostscript. Under Windows,
+current versions of both MiKTeX and TeX Live include pdftops. Still, you
+may opt @i{not} to use pdftops even if it is available, in which case
+Ghostscript will be used instead.
 
 @node Command-line usage, Notes on PostScript and pdf, Usage, Top
 @chapter Command-line usage
@@ -287,8 +286,8 @@ epspdf [@var{options}] @var{infile} [@var{outfile}]
 Typing  @kbd{epspdf --help} gives you the following summary:
 @example
 $ epspdf --help
-Epspdf version 0.6.3
-Copyright (c) 2006, 2008, 2009, 2010, 2011, 2013, 2014, 2015, 2016 Siep Kroonenberg
+Epspdf version 0.6.4
+Copyright (c) 2006-2019 Siep Kroonenberg
 
 Convert between [e]ps and pdf formats
 Usage: epspdf[.tlu] [options] infile [outfile]
@@ -304,7 +303,7 @@ Default for outfile is file.eps if infile is file.pdf
 -T, --target TARGET
             One of screen, ebook, printer, prepress or default
 -N, --pdfversion VERSION
-            One of 1.2, 1.3, 1.4 or default
+            One of 1.2, 1.3, 1.4, 1.5, 1.6, 1.7 or default
 -U          Use pdftops if available
 -I          Reverses the above
 -s, --save  Save some settings to configuration file
@@ -349,7 +348,7 @@ bitmaps have (much) larger file sizes, and take longer to process.
 So avoid converting vector to bitmap. However, converting from bitmap to
 vector is also best avoided, since it is very hard to do well.
 
-Epspdf normally avoids conversion from vector to bitmap and never
+Epspdf usually avoids conversion from vector to bitmap and never
 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.
@@ -359,18 +358,17 @@ resolution.
 
 When converting to pdf, Ghostscript handles font embedding differently
 depending on the ``Target use'' option. According to the Ghostscript
-documentation, it embeds all fonts without exception for prepress- and
-printer settings. Epspdf enforces this also for default settings. For
-screen- and ebook settings, standard fonts such as Times may be omitted.
+documentation, it embeds all fonts without exception for all targets
+except ``screen'', for which standard fonts such as Times may be
+omitted.
 
 @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
-preview headers are used by e.g. desktop-publishing software to
-represent eps files on screen without having to interpret the
-PostScript code itself. Epspdf currently has no option to preserve
-or add them.
+Preview headers are quietly stripped from eps files. These preview
+headers are used by e.g. desktop-publishing software to represent eps
+files on screen without having to interpret the PostScript code
+itself. Epspdf has no option to preserve or add them.
 
 @node Bounding- and other boxes, Orientation, Eps preview headers, Notes on PostScript and pdf
 @section Bounding- and other boxes
@@ -380,36 +378,33 @@ file may have a mediabox, a trimbox and various other boxes. Ghostscript
 by itself normally converts the PostScript page -- which is anchored at
 (0,0) -- to the pdf mediabox.
 
-Conversion from eps to pdf usually translates the bottom-left corner to
-the (0,0) origin and sets the page to the size of the graphic. Anything
-outside the boundingbox should be cut off.
-
-I have seen Illustrator-generated pdf files with negative coordinates
-for the lower-left corner. However, this does not seem to cause
-problems.
+Conversion to pdf usually translates the bottom-left corner to the (0,0)
+origin and sets the @dots{}box to the size of the
+graphic. Anything outside the @dots{}box should be cut off.
 
 @node Orientation, Exporting PostScript or pdf 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-
-and pdf files. This may result part of a graphic being cut off after
-conversion or even everything falling outside the page / mediabox /
-boundingbox.
+Ghostscript may not be able to determine the right orientation of a
+PostScript- or pdf file. This may result in part of a graphic being cut
+off after conversion or even everything falling outside the page /
+mediabox / boundingbox.
 
 @node Exporting PostScript or pdf from Windows programs,  , Orientation, Notes on PostScript and pdf
 @section Exporting PostScript or pdf from Windows programs
 
 Microsoft Office 2010 can now export to pdf, either the entire document
-or a selection. This removes a major headache for Windows users.
-
-As a last resort, you can ``print'' to a PostScript file. From some
-programs, you can print a selection. A suitable driver which comes with
-Windows is Generic / MS Publisher Color Printer. Pay attention to the
-printer properties: choose ``Outline'' for font downloading and avoid
-the ``Optimize for speed'' setting for PostScript Output Option. In my
-tests, ``Encapsulated PostScript'' did not look very promising
-either. Try e.g. ``Archive'' instead. These options can be found under
-the Advanced button.
+or a selection. This removes a major headache for Windows users. Windows
+10 also includes a pdf printer.
+
+As a last resort on earlier Windows versions, you can ``print'' to a
+PostScript file. From some programs, you can print a selection. A
+suitable driver which comes with Windows is Generic / MS Publisher Color
+Printer. Pay attention to the printer properties: choose ``Outline'' for
+font downloading and avoid the ``Optimize for speed'' setting for
+PostScript Output Option. In my tests, ``Encapsulated PostScript'' did
+not look very promising either. Try e.g. ``Archive'' instead. These
+options can be found under the Advanced button.
 
 @node Bitmapped graphics for @LaTeX{} and pdflatex, Troubleshooting, Notes on PostScript and pdf, Top
 @chapter Bitmapped graphics for @LaTeX{} and pdflatex
@@ -420,11 +415,11 @@ stuck with .eps format. Tips for converting to .eps:
 
 @menu
 * Linux::
-* Mac OS X::
+* Mac OS::
 * Windows::
 @end menu
 
-@node Linux, Mac OS X, Bitmapped graphics for @LaTeX{} and pdflatex, Bitmapped graphics for @LaTeX{} and pdflatex
+@node Linux, Mac OS, Bitmapped graphics for @LaTeX{} and pdflatex, Bitmapped graphics for @LaTeX{} and pdflatex
 @section Linux
 
 @table @emph
@@ -442,19 +437,19 @@ pre-installed on Linux, and is also available for other platforms. The
 GIMP can save in eps- and pdf format.
 @end table
 
-@node Mac OS X, Windows, Linux, Bitmapped graphics for @LaTeX{} and pdflatex
-@section Mac OS X
+@node Mac OS, Windows, Linux, Bitmapped graphics for @LaTeX{} and pdflatex
+@section Mac OS
 
-Mac OS X's built-in Preview application can read most bitmapped formats
+Mac OS's built-in Preview application can read most bitmapped formats
 and save them as pdf or PostScript. In fact, in many cases it is an
 excellent alternative to epspdf.
 
-@node Windows,  , Mac OS X, Bitmapped graphics for @LaTeX{} and pdflatex
+@node Windows,  , Mac OS, Bitmapped graphics for @LaTeX{} and pdflatex
 @section Windows
 
-I know of no built-in facility for converting bitmaps to eps or
-pdf. However, many image editors can convert to eps or pdf. A couple of
-command-line utilities:
+I know of no built-in facility for converting bitmaps to eps or pdf,
+apart from ``printing'' to PostScript or pdf. However, many image
+editors can convert to eps or pdf. A couple of command-line utilities:
 @example
 sam2p image.png image.eps
 @end example
@@ -515,11 +510,11 @@ xpdf suite and of the Poppler utilities.
 @node The page has been converted to a bitmap, Temporary files are not removed, Fonts look ugly, Troubleshooting
 @section The page has been converted to a bitmap
 
-This may happen if the page contains features such as transparency which
-are not supported by intermediate formats.
+The usual cause is that the page contains features such as transparency which
+are not supported by the target format.
 
-Set pdf target use and target version both to ``default'' to avoid
-unnecessary conversions: @code{-T default -N default}
+Otherwise, set pdf target use and target version both to ``default'' to
+avoid unnecessary conversions: @code{-T default -N default}
 
 @node Temporary files are not removed, Resources for troubleshooting, The page has been converted to a bitmap, Troubleshooting
 @section Temporary files are not removed
@@ -541,11 +536,10 @@ have no trouble removing temporary files manually.
 
 @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
+Mac OS 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:\Users\@var{your user name}\AppData\Roaming} or
-@file{c:\Documents and Settings\@var{your user name}\Application
-Data}. Type 
+directory may be @file{c:\Users\@var{your user
+name}\AppData\Roaming}. Type
 @example
 echo %APPDATA%
 @end example
@@ -561,19 +555,54 @@ files. Check the log(file) as to which temporary files have been
 created.
 
 @anchor{Documentation}@i{Ghostscript- and pdftops documentation.} For
-Ghostscript, the most important files are Ps2pdf.htm and Use.htm. For
+Ghostscript, the most important files are VectorDevices.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.
+for Windows there is a file pdftops.txt in the distribution zip. TeX
+Live includes the man page in pdf format: pdftops.pdf.
+
+@node Requirements
+@appendix Requirements
+
+Epspdftk consists of a GUI front end and a command-line back end.
+
+The command-line component, which can be used separately from the front
+end, requires ghostscript and a not too old @TeX{} installation with
+luatex. It may further benefit from the presence of pdftops. MiKTeX and
+TeX Live for Windows meet these requirements out of the box.
+
+The front end requires a Tcl/Tk installation, or at least a tclkit
+runtime. TeX Live for Windows contains such a tclkit since late 2018,
+and epspdftk as a TeX Live package will make use of it. The minimum
+version is 8.5.
+
+For Windows there is an alternate epspdf-setup package on CTAN with an
+embedded Tcl/Tk runtime and a regular Windows installer, which also
+creates a menu shortcut and an uninstaller.
 
 @node Change history,  , Troubleshooting, Top
-@chapter Change history
+@appendix Change history
 
 @menu
+* Version 6.4::
 * Version 0.6::
 * Version 0.5::
 * Version 0.4::
 @end menu
 
+@node Version 6.4
+@section Version 6.4
+
+Compatibility changes for luatex 1.9 and later.
+
+The location of pdftops is no longer configurable; it is only searched
+for on the searchpath.
+
+Some corner cases should be handled more successfully.
+
+The GUI now requires Tcl/Tk version 8.5 or higher. On Windows,
+epspdf.tlu is now invoked via a batchfile. This should prevent black
+console windows popping up.
+
 @node Version 0.6, Version 0.5, Change history, Change history
 @section Version 0.6
 
@@ -585,11 +614,9 @@ output. This also works for bitmaps.
 
 Croppping of pdfs is now accomplished by running luatex on a suitable
 wrapper file (same method as Heiko Oberdiek's pdfcrop). Such a
-conversion preserves advanced features which might otherwise get lost
-during a PostScript round-trip.
+conversion preserves advanced features which might otherwise get lost.
 
-I no longer own a Mac, and therefore no longer try to provide an
-AppleScript wrapper.
+I no longer try to provide an AppleScript wrapper.
 
 The current version has no provisions for custom Ghostscript- or pdftops
 parameters. The corresponding command-line options are accepted but have
@@ -607,7 +634,7 @@ 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
+configuration file. For Linux/Unix/Mac OS 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
@@ -622,7 +649,7 @@ 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
+The ``Open with@dots{}'' option for Windows has been dropped for technical
 reasons.
 
 The ``--version'' option now prints the version string instead of