summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/scripts/epspdf/epspdf.help
diff options
context:
space:
mode:
authorSiep Kroonenberg <siepo@cybercomm.nl>2010-03-29 10:40:34 +0000
committerSiep Kroonenberg <siepo@cybercomm.nl>2010-03-29 10:40:34 +0000
commit94f4030050e1d0cbad1ee1f93076439592593b93 (patch)
tree1a223bbee33e5ae625f6e1f0311b0cde6531c367 /Master/texmf-dist/scripts/epspdf/epspdf.help
parent83a96bd3d13d3ce3881bb6ab5058687d252cc771 (diff)
Epspdf rev. 0.5
git-svn-id: svn://tug.org/texlive/trunk@17604 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/scripts/epspdf/epspdf.help')
-rw-r--r--Master/texmf-dist/scripts/epspdf/epspdf.help123
1 files changed, 81 insertions, 42 deletions
diff --git a/Master/texmf-dist/scripts/epspdf/epspdf.help b/Master/texmf-dist/scripts/epspdf/epspdf.help
index 6a5687aed69..4a43acbcd3d 100644
--- a/Master/texmf-dist/scripts/epspdf/epspdf.help
+++ b/Master/texmf-dist/scripts/epspdf/epspdf.help
@@ -1,7 +1,7 @@
Epspdf and epsdftk
******************
-This manual is for epspdf, version 0.4.3.
+This manual is for epspdf, version 0.5.
Copyright (C) 2006, 2008, 2009, 2010 Siep Kroonenberg.
@@ -32,12 +32,7 @@ in the box in the upper part of the screen.
The View button at the bottom of the screen calls an appropriate
external viewer.
-Windows: Epspdftk simply tries to use the default Open command. A
-second button, labeled 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 View
-with... button.
+Windows and OS X: Epspdftk simply tries to use the default Open command.
Under Linux the PostScript- and pdf viewers are configurable; see *note
The configuration screen::.
@@ -62,10 +57,9 @@ 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.
+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.
@@ -93,8 +87,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.
1.5.2 Options for converting to pdf
-----------------------------------
@@ -115,7 +108,7 @@ Ps2pdf.htm.
For conversion the other way you may opt 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.
+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.
@@ -123,9 +116,8 @@ location of pdftops.exe.
1.5.4 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:
* When converting to pdf, it uses the standard rather than the hires
boundingbox for page dimensions
@@ -136,9 +128,8 @@ It has two effects:
2 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.
@@ -160,7 +151,7 @@ Basic usage:
Typing `epspdf --help' gives you the following summary:
$ 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]
@@ -178,7 +169,6 @@ Typing `epspdf --help' gives you the following summary:
-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
@@ -192,8 +182,9 @@ Typing `epspdf --help' gives you the following summary:
-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
3 Notes on PostScript and pdf
@@ -384,39 +375,87 @@ Things to try:
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.
+
+5.4 Epspdftk quit unexpectedly (Mac OS X applet)
+================================================
+
+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.
-5.4 Resources for troubleshooting
+5.5 Resources for troubleshooting
=================================
-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 `c:\Documents and Settings\YOUR USER NAME'.
-Otherwise, open a DOS box and type `echo %USERPROFILE%', which will
-produce this information.
+Logfile. The GUI has a button for viewing log output. This same output
+is also written to a 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 `%APPDATA%'. This APPDATA directory may be
+`c:\Documents and Settings\YOUR USER NAME\Application Data' or
+`c:\Users\YOUR USER NAME\AppData\Roaming'. Otherwise, open a command
+prompt and type `echo %APPDATA%', which will produce this information.
-This logfile lists all Ghostscript- and pdftops program 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.
+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.
-Temporary files. The temporary files may give clues as well. They will
-be deleted at the end of the session (for the command-line version,
-give a -d parameter to keep the temporary files). Check the logfile as
-to which temporary files have been created.
+Temporary files. The temporary files may give clues as well. Uncheck
+the button "Remove temp files", or for the command-line version, give a
+-d parameter to keep the temporary files. Check the log(file) as to
+which temporary files have been created.
Ghostscript- and pdftops documentation. For Ghostscript, the most
important files are Ps2pdf.htm and Use.htm. For pdftops, type `pdftops
-h'. For Unix, there is also a man page, and for Windows there is a
file pdftops.txt in the distribution zip.
-6 Changes in version 0.4
-************************
+6 Change history
+****************
+
+6.1 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 `epspdftk.tcl' and a Tcl/Tk runtime. See
+`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 `$HOME/.epspdf',
+for Windows it is `%APPDATA%\epspdf'. On all supported platforms,
+settings are stored in the 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.
+
+6.2 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 use