summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1/epstopdf.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf/doc/man/man1/epstopdf.1')
-rw-r--r--Master/texmf/doc/man/man1/epstopdf.177
1 files changed, 47 insertions, 30 deletions
diff --git a/Master/texmf/doc/man/man1/epstopdf.1 b/Master/texmf/doc/man/man1/epstopdf.1
index ca7c16b9018..a89e1e0e92e 100644
--- a/Master/texmf/doc/man/man1/epstopdf.1
+++ b/Master/texmf/doc/man/man1/epstopdf.1
@@ -1,39 +1,52 @@
-.TH EPSTOPDF 1 "4 March 2008"
+.TH EPSTOPDF 1 "27 September 2009"
+.\" $Id: epstopdf.1 15532 2009-09-28 15:55:43Z karl $
.\" man page originally by Jim Van Zandt
.SH NAME
epstopdf \- convert an EPS file to PDF
.SH SYNOPSIS
-\fBepstopdf\fP [\fIoptions\fP] \fIepsfile\fP
+\fBepstopdf\fP [\fIoptions\fP] [\fIepsfile\fP]
.SH DESCRIPTION
-\fBepstopdf\fP transforms the Encapsulated PostScript file
-\fIepsfile\fP so that it is guaranteed to start at the 0,0 coordinate,
-and it sets a page size exactly corresponding to the BoundingBox.
-This means that when Ghostscript renders it, the result needs no
-cropping, and the PDF MediaBox is correct. The result is piped to
-Ghostscript and a PDF version written.
+\fBepstopdf\fP transforms the Encapsulated PostScript file \fIepsfile\fP
+(or standard input) so that it is guaranteed to start at the 0,0
+coordinate, and it sets a page size exactly corresponding to the
+BoundingBox. This means that when Ghostscript renders it, the result
+needs no cropping, and the PDF MediaBox is correct. By default, the
+result is piped to Ghostscript and a PDF version written.
.P
-If the bounding box is not right, of course, you have problems.
+If the bounding box is not right, of course, there are problems.
.SH OPTIONS
.IP "\fB--outfile\fP=\fIfile\fP"
-write result to \fIfile\fP instead of standard output.
+write result to \fIfile\fP; the default is to construct the output file
+name by replacing any extension in the input file with \fI.pdf\fP. If
+\fB--nogs\fP or \fB--filter\fP is specified, write to standard output.
+.IP "\fB--\fP[\fBno\fP]\fBcompress\fP"
+use compression (default: on).
+.IP "\fB--\fP[\fBno\fP]\fBdebug\fP"
+write debugging info (default: off).
+.IP "\fB--\fP[\fBno\fP]\fBembed\fP"
+embed fonts (default: on).
+.IP "\fB--\fP[\fBno\fP]\fBexact\fP"
+scan ExactBoundingBox (default: off).
.IP "\fB--\fP[\fBno\fP]\fBfilter\fP"
-read standard input (default: --nofilter).
+read standard input (default: off).
.IP "\fB--\fP[\fBno\fP]\fBgs\fP"
-run ghostscript (default: --gs).
-.IP "\fB--\fP[\fBno\fP]\fBcompress\fP"
-use compression (default: --compress).
+run ghostscript (default: on).
.IP "\fB--\fP[\fBno\fP]\fBhires\fP"
-scan HiresBoundingBox (default: --nohires).
-.IP "\fB--\fP[\fBno\fP]\fBexact\fP"
-scan ExactBoundingBox (default: --noexact).
-.IP "\fB--\fP[\fBno\fP]\fBdebug\fP"
-debug informations (default: --nodebug).
+scan HiresBoundingBox (default: off).
+.IP "\fB--gscmd\fP=\fIval\fP"
+pipe output to \fIval\fP (default: [\fBgswin32c\fP on Windows, else \fBgs\fP])
+.IP "\fB--res\fP=\fIdpi\fP"
+set image resolution (default: [use gs default])
+.IP "\fB--autorotate\fP=\fIval\fP"
+set AutoRotatePages (default: None); recognized \fIval\fP choices:
+None, All, PageByPage. For EPS files, PageByPage is equivalent to All.
.IP "\fB--help\fP
-print usage
-.SH EXAMPLE
+display help message and exit
+.IP "\fB--version\fP
+display version information and exit
+.SH EXAMPLES
Examples for producing "test.pdf":
.nf
-
epstopdf test.eps
produce postscript | epstopdf --filter >test.pdf
produce postscript | epstopdf -f -d -o=test.pdf
@@ -41,21 +54,25 @@ produce postscript | epstopdf -f -d -o=test.pdf
.fi
Example: look for HiresBoundingBox and produce corrected PostScript:
.nf
-
-epstopdf -d --nogs -hires test.ps>testcorr.ps
+epstopdf -d --nogs --hires test.ps >testcorr.ps
.fi
.SH BUGS
-The case of "%%BoundingBox: (atend)" is not supported.
+The case of "%%BoundingBox: (atend)"
+when input is not seekable (e.g., from a pipe) is not supported.
.PP
-Please send reports regarding the program or this man page
-to tex-k@tug.org.
+When reporting bugs, please include an input file and command line
+options so the problem can be reproduced. Report bugs in
+the program or this man page to tex-k@tug.org.
.SH SEE ALSO
-\fBgs\fP(1).
+\fBgs\fP(1),
+\fBpdfcrop\fP(1).
.SH AUTHOR
The script was originally written by Sebastian Rahtz, for Elsevier
-Science, with subsequent contributions from many others. Currently
-maintained by Gerben Wierda.
+Science, with subsequent contributions from Gerben Wierda and many
+others. Currently maintained by Karl Berry.
.PP
Man page originally written by Jim Van Zandt.
.PP
+epstopdf home page: http://tug.org/epstopdf/
+.PP
You may freely use, modify and/or distribute this file.