texlive[49952] Master/texmf-dist/doc/support/epspdf: Updates to
commits+siepo at tug.org
commits+siepo at tug.org
Tue Feb 5 23:55:48 CET 2019
Revision: 49952
http://tug.org/svn/texlive?view=revision&revision=49952
Author: siepo
Date: 2019-02-05 23:55:48 +0100 (Tue, 05 Feb 2019)
Log Message:
-----------
Updates to epspdf manual
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/support/epspdf/Changelog
trunk/Master/texmf-dist/doc/support/epspdf/README
trunk/Master/texmf-dist/doc/support/epspdf/epspdf.pdf
trunk/Master/texmf-dist/doc/support/epspdf/epspdf.texi
Modified: trunk/Master/texmf-dist/doc/support/epspdf/Changelog
===================================================================
--- trunk/Master/texmf-dist/doc/support/epspdf/Changelog 2019-02-05 22:51:58 UTC (rev 49951)
+++ trunk/Master/texmf-dist/doc/support/epspdf/Changelog 2019-02-05 22:55:48 UTC (rev 49952)
@@ -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
Modified: trunk/Master/texmf-dist/doc/support/epspdf/README
===================================================================
--- trunk/Master/texmf-dist/doc/support/epspdf/README 2019-02-05 22:51:58 UTC (rev 49951)
+++ trunk/Master/texmf-dist/doc/support/epspdf/README 2019-02-05 22:55:48 UTC (rev 49952)
@@ -3,10 +3,15 @@
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.
Modified: trunk/Master/texmf-dist/doc/support/epspdf/epspdf.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/support/epspdf/epspdf.texi
===================================================================
--- trunk/Master/texmf-dist/doc/support/epspdf/epspdf.texi 2019-02-05 22:51:58 UTC (rev 49951)
+++ trunk/Master/texmf-dist/doc/support/epspdf/epspdf.texi 2019-02-05 22:55:48 UTC (rev 49952)
@@ -29,16 +29,15 @@
@hyphenation{epspdf-tk epspdf}
@end iftex
- at set version 0.6.3
- at set homepage http://tex.aanhet.net/epspdf/
+ at 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 @@
@sp 1
@center A cross-platform GUI- and command-line converter for [e]ps and pdf
@sp 2
- at center Siep Kroonenberg (@email{n dot s dot kroonenberg at rug dot nl})
+ at center Siep Kroonenberg (@email{siepo at bitmuis dot nl})
@vskip 0pt plus 1filll
@insertcopying
@end titlepage
@@ -78,6 +77,7 @@
* Notes on PostScript and pdf::
* Bitmapped graphics for @LaTeX{} and pdflatex::
* Troubleshooting::
+* Requirements::
* Change history::
@detailmenu
@@ -107,7 +107,7 @@
Bitmapped graphics for @LaTeX{} and pdflatex
* Linux::
-* Mac OS X::
+* Mac OS::
* Windows::
Troubleshooting
@@ -122,6 +122,7 @@
Change history
+* Version 6.4::
* Version 0.6::
* Version 0.5::
* Version 0.4::
@@ -143,29 +144,28 @@
@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
- at noindent @image{images/main_w8,,3in}
+ at noindent @image{images/main_wx,,2.9in}
@iftex
@hfill
@end iftex
- at image{images/cnv_linux,,3in}
+ at 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.
- at i{Windows and OS X:} Epspdftk simply tries to use the default Open
+ at 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 @@
@node Conversion options, Converting, Viewing, Usage
@section Conversion options
- at anchor{gray}@i{Grayscaling:} Grayscaling is now done by Ghostscript
-itself and should ``just work''.
+ at itemize
+ at item
+ at anchor{gray}Grayscaling
- at i{Compute tight boundingbox:} This option is only available
+ at item
+Compute tight boundingbox. This option is only available
if a single page is converted.
- at i{Page selection:} The only possibilities are selecting a single page
+ at item
+Page selection. The only possibilities are selecting a single page
or selecting all pages. Converting to eps implies selecting a single
page.
+ at 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.
+ at 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 @@
@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 at 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 @@
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,36 +233,29 @@
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.
+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.
-Under an older MikTeX without bundled pdftops, this is also the place to
-point the program to the location of pdftops.exe.
-
@node Command-line usage, Notes on PostScript and pdf, Usage, Top
@chapter Command-line usage
@@ -287,8 +286,8 @@
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 @@
-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 @@
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 @@
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 @@
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.
+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.
-I have seen Illustrator-generated pdf files with negative coordinates
-for the lower-left corner. However, this does not seem to cause
-problems.
-
@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.
+or a selection. This removes a major headache for Windows users. Windows
+10 also includes a pdf printer.
-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.
+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 @@
@menu
* Linux::
-* Mac OS X::
+* Mac OS::
* Windows::
@end menu
- at node Linux, Mac OS X, Bitmapped graphics for @LaTeX{} and pdflatex, Bitmapped graphics for @LaTeX{} and pdflatex
+ at node Linux, Mac OS, Bitmapped graphics for @LaTeX{} and pdflatex, Bitmapped graphics for @LaTeX{} and pdflatex
@section Linux
@table @emph
@@ -442,19 +437,19 @@
GIMP can save in eps- and pdf format.
@end table
- at node Mac OS X, Windows, Linux, Bitmapped graphics for @LaTeX{} and pdflatex
- at section Mac OS X
+ at node Mac OS, Windows, Linux, Bitmapped graphics for @LaTeX{} and pdflatex
+ at 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.
- at node Windows, , Mac OS X, Bitmapped graphics for @LaTeX{} and pdflatex
+ at 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 @@
@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 @@
@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
- at 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 @@
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.
+ at node Requirements
+ at 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
- at chapter Change history
+ at appendix Change history
@menu
+* Version 6.4::
* Version 0.6::
* Version 0.5::
* Version 0.4::
@end menu
+ at node Version 6.4
+ at 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 @@
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 @@
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 @@
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 at dots{}'' option for Windows has been dropped for technical
reasons.
The ``--version'' option now prints the version string instead of
More information about the tex-live-commits
mailing list