epstopdf 2.21 (17jan14)

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

6 files changed, 67 insertions, 32 deletions

diff --git a/Build/source/texk/texlive/linked_scripts/epstopdf/epstopdf.pl b/Build/source/texk/texlive/linked_scripts/epstopdf/epstopdf.pl
index 276eb3631b2..3d5bd54bfc3 100755
--- a/Build/source/texk/texlive/linked_scripts/epstopdf/epstopdf.pl
+++ b/Build/source/texk/texlive/linked_scripts/epstopdf/epstopdf.pl
@@ -1,5 +1,5 @@
 #!/usr/bin/env perl
-# $Id: epstopdf.pl 31784 2013-09-27 22:43:16Z karl $
+# $Id: epstopdf.pl 32701 2014-01-17 18:09:54Z karl $
 # (Copyright lines below.)
 #
 # Redistribution and use in source and binary forms, with or without
@@ -34,7 +34,11 @@
 # "%%BoundingBox: (atend)" when input is not seekable (e.g., from a pipe),
 #
 # emacs-page
+my $ver = "2.21";
+
 # History
+#  2014/01/17 v2.21 (Karl Berry)
+#    * tweaks to help message, per reports from Knuth.
 #  2013/09/28 v2.20 (Heiko Oberdiek, and (a little) Karl Berry)
 #    * New command line argument --(no)safer which allows setting
 #      -dNOSAFER instead of -dSAFER (only for non-restricted).
@@ -161,9 +165,9 @@
 ### emacs-page
 ### program identification
 my $program = "epstopdf";
-my $ident = '($Id: epstopdf.pl 31784 2013-09-27 22:43:16Z karl $) 2.18';
+my $ident = '($Id: epstopdf.pl 32701 2014-01-17 18:09:54Z karl $)' . " $ver";
 my $copyright = <<END_COPYRIGHT ;
-Copyright 2009-2013 Karl Berry et al.
+Copyright 2009-2014 Karl Berry et al.
 Copyright 2002-2009 Gerben Wierda et al.
 Copyright 1998-2001 Sebastian Rahtz et al.
 License RBSD: Revised BSD <http://www.xfree86.org/3.3.6/COPYRIGHT2.html#5>
@@ -340,7 +344,7 @@ The resulting output is guaranteed to start at the 0,0 coordinate, and
 sets a page size exactly corresponding to the BoundingBox.  Thus, the
 result does not need any cropping, and the PDF MediaBox is correct.
 
-If the bounding box in the input EPS is not right, of course there will
+If the bounding box in the input is incorrect, of course there will
 be resulting problems.
 
 Options:
@@ -348,12 +352,13 @@ Options:
   --version          display version information and exit
 
   --outfile=FILE     write result to FILE   (default based on input name)
-  --(no)debug        write debugging info   (default: $bool[$::opt_debug])
+  --restricted       use restricted mode    (default: $bool[$restricted])
+
+  --(no)debug        output debugging info  (default: $bool[$::opt_debug])
   --(no)exact        scan ExactBoundingBox  (default: $bool[$::opt_exact])
   --(no)filter       read standard input    (default: $bool[$::opt_filter])
   --(no)gs           run ghostscript        (default: $bool[$::opt_gs])
   --(no)hires        scan HiResBoundingBox  (default: $bool[$::opt_hires])
-  --restricted       use restricted mode    (default: $bool[$restricted])
 
 Options for Ghostscript:
   --gscmd=VAL        pipe output to VAL     (default: $GS)
@@ -373,13 +378,19 @@ Options for Ghostscript:
                        ignored if option --debug is set.
   --(no)safer        use -d(NO)SAFER        (default: $bool[$::opt_safer])
 
-Examples producing test.pdf:
+Examples all equivalently converting test.eps to test.pdf:
   \$ $program test.eps
   \$ cat test.eps | $program --filter >test.pdf
   \$ cat test.eps | $program -f -o=test.pdf
 
-Example to look for HiResBoundingBox and produce corrected PostScript:
-  \$ $program -d --nogs --hires test.ps >testcorr.ps
+Example for using HiResBoundingBox instead of BoundingBox:
+  \$ $program --hires test.eps
+
+Example for producing epstopdf's attempt at corrected PostScript:
+  \$ $program --nogs test.ps >testcorr.ps
+
+In all cases, you can add --debug (-d) to see more about what epstopdf
+is doing.
 
 More about the options for Ghostscript:
   Additional options to be used with gs can be specified
@@ -419,7 +430,7 @@ GetOptions (
   "gscmd=s",              # \ref{val_gscmd}
   "gsopt=s@",             # \ref{val_gsopt}
   "gsopts=s" => \&gsopts, # \ref{val_gsopts}
-  "help",
+  "help|h",
   "hires!",
   "outfile=s",            # \ref{openout_any}
   "pdfsettings=s",
@@ -428,7 +439,7 @@ GetOptions (
   "restricted",
   "safer!",
   "version",
-) or die $usage;
+) or die "Try $0 --help for more information\n";
 
 ### disable --quiet if option --debug is given
 $::opt_quiet = 0 if $::opt_debug;
diff --git a/Master/texmf-dist/doc/man/man1/epstopdf.1 b/Master/texmf-dist/doc/man/man1/epstopdf.1
index 5d95bd8f2c1..cb3fb4519ce 100644
--- a/Master/texmf-dist/doc/man/man1/epstopdf.1
+++ b/Master/texmf-dist/doc/man/man1/epstopdf.1
@@ -1,20 +1,23 @@
-.TH EPSTOPDF 1 "28 September 2013"
-.\" $Id: epstopdf.1 31784 2013-09-27 22:43:16Z karl $
+.TH EPSTOPDF 1 "17 January 2014"
+.\" $Id: epstopdf.1 32701 2014-01-17 18:09:54Z karl $
 .SH NAME
 epstopdf, repstopdf \- convert an EPS file to PDF
 .SH SYNOPSIS
 \fBepstopdf\fP [\fIoptions\fP] [\fIepsfile\fP]
 .SH DESCRIPTION
-\fBepstopdf\fP transforms the Encapsulated PostScript file \fIepsfile\fP
+By default, \fBepstopdf\fP converts the input PostScript file to PDF,
+using Ghostscript.
+.PP
+\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.  Thus, the result needs no cropping, and the PDF MediaBox
-is correct.  By default, the input is converted to PDF using Ghostscript.
+is correct.  
 .PP
 PJL commands at the start of a file are removed.  DOS EPS binary files
 (TN 5002) are supported.
 .PP
-If the bounding box in the input file is not right, of course there will
+If the bounding box in the input is incorrect, of course there will
 be resulting problems.
 .SH OPTIONS
 Options may start with either "\fB-\fP" or "\fB--\fP", and may be
@@ -98,17 +101,25 @@ known to be safe; some options taking booleans, integers or fixed
 names are allowed, those taking general strings are not.
 
 .SH EXAMPLES
-Examples all equivalently producing `test.pdf':
+Examples all equivalently converting `test.eps' to `test.pdf':
 .nf
 epstopdf test.eps
 cat test.eps | epstopdf --filter >test.pdf
-cat test.eps | epstopdf -f -d -o=test.pdf
+cat test.eps | epstopdf -f -o=test.pdf
 .fi
 .PP
-Example to look for HiResBoundingBox and produce corrected PostScript:
+Example for using HiResBoundingBox instead of BoundingBox:
 .nf
-epstopdf -d --nogs --hires test.ps >testcorr.ps 
+epstopdf --hires test.eps
 .fi
+.PP
+Example for producing \fBepstopdf\fP's attempt at corrected PostScript:
+.nf
+$program --nogs test.ps >testcorr.ps
+.fi
+.PP
+In all cases, you can add \fB--debug\fP (\fB-d\fP) to see more about
+what \fBepstopdf\fP is doing.
 .SH BUGS
 The case of "%%BoundingBox: (atend)" when input is not seekable (e.g.,
 from a pipe) is not supported.
diff --git a/Master/texmf-dist/doc/man/man1/epstopdf.man1.pdf b/Master/texmf-dist/doc/man/man1/epstopdf.man1.pdf
index 91dae4561c8..fec401f3de2 100644
--- a/Master/texmf-dist/doc/man/man1/epstopdf.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/epstopdf.man1.pdf
diff --git a/Master/texmf-dist/doc/man/man1/repstopdf.man1.pdf b/Master/texmf-dist/doc/man/man1/repstopdf.man1.pdf
index ea9fade0492..56f14e52b74 100644
--- a/Master/texmf-dist/doc/man/man1/repstopdf.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/repstopdf.man1.pdf
diff --git a/Master/texmf-dist/doc/support/epstopdf/README b/Master/texmf-dist/doc/support/epstopdf/README
index 8db80193760..26a37f7276c 100644
--- a/Master/texmf-dist/doc/support/epstopdf/README
+++ b/Master/texmf-dist/doc/support/epstopdf/README
@@ -1,4 +1,4 @@
-$Id: README 17507 2010-03-19 22:52:56Z karl $
+$Id: README 32701 2014-01-17 18:09:54Z karl $
 This file is public domain.  (Originally written by Karl Berry, 2009.)
 
 This is the README for the epstopdf script distribution.
@@ -8,6 +8,8 @@ Primary distribution point: http://mirror.ctan.org/support/epstopdf/
 
 Home page: http://tug.org/epstopdf/
 
+Run epstopdf --help for the usual list of options, examples, etc.
+
 Mailing list for bugs and discussion: http://lists.tug.org/tex-k
 When reporting bugs, please include an input file and command line
 options, so the problem can be reproduced.
diff --git a/Master/texmf-dist/scripts/epstopdf/epstopdf.pl b/Master/texmf-dist/scripts/epstopdf/epstopdf.pl
index 276eb3631b2..3d5bd54bfc3 100755
--- a/Master/texmf-dist/scripts/epstopdf/epstopdf.pl
+++ b/Master/texmf-dist/scripts/epstopdf/epstopdf.pl
@@ -1,5 +1,5 @@
 #!/usr/bin/env perl
-# $Id: epstopdf.pl 31784 2013-09-27 22:43:16Z karl $
+# $Id: epstopdf.pl 32701 2014-01-17 18:09:54Z karl $
 # (Copyright lines below.)
 #
 # Redistribution and use in source and binary forms, with or without
@@ -34,7 +34,11 @@
 # "%%BoundingBox: (atend)" when input is not seekable (e.g., from a pipe),
 #
 # emacs-page
+my $ver = "2.21";
+
 # History
+#  2014/01/17 v2.21 (Karl Berry)
+#    * tweaks to help message, per reports from Knuth.
 #  2013/09/28 v2.20 (Heiko Oberdiek, and (a little) Karl Berry)
 #    * New command line argument --(no)safer which allows setting
 #      -dNOSAFER instead of -dSAFER (only for non-restricted).
@@ -161,9 +165,9 @@
 ### emacs-page
 ### program identification
 my $program = "epstopdf";
-my $ident = '($Id: epstopdf.pl 31784 2013-09-27 22:43:16Z karl $) 2.18';
+my $ident = '($Id: epstopdf.pl 32701 2014-01-17 18:09:54Z karl $)' . " $ver";
 my $copyright = <<END_COPYRIGHT ;
-Copyright 2009-2013 Karl Berry et al.
+Copyright 2009-2014 Karl Berry et al.
 Copyright 2002-2009 Gerben Wierda et al.
 Copyright 1998-2001 Sebastian Rahtz et al.
 License RBSD: Revised BSD <http://www.xfree86.org/3.3.6/COPYRIGHT2.html#5>
@@ -340,7 +344,7 @@ The resulting output is guaranteed to start at the 0,0 coordinate, and
 sets a page size exactly corresponding to the BoundingBox.  Thus, the
 result does not need any cropping, and the PDF MediaBox is correct.
 
-If the bounding box in the input EPS is not right, of course there will
+If the bounding box in the input is incorrect, of course there will
 be resulting problems.
 
 Options:
@@ -348,12 +352,13 @@ Options:
   --version          display version information and exit
 
   --outfile=FILE     write result to FILE   (default based on input name)
-  --(no)debug        write debugging info   (default: $bool[$::opt_debug])
+  --restricted       use restricted mode    (default: $bool[$restricted])
+
+  --(no)debug        output debugging info  (default: $bool[$::opt_debug])
   --(no)exact        scan ExactBoundingBox  (default: $bool[$::opt_exact])
   --(no)filter       read standard input    (default: $bool[$::opt_filter])
   --(no)gs           run ghostscript        (default: $bool[$::opt_gs])
   --(no)hires        scan HiResBoundingBox  (default: $bool[$::opt_hires])
-  --restricted       use restricted mode    (default: $bool[$restricted])
 
 Options for Ghostscript:
   --gscmd=VAL        pipe output to VAL     (default: $GS)
@@ -373,13 +378,19 @@ Options for Ghostscript:
                        ignored if option --debug is set.
   --(no)safer        use -d(NO)SAFER        (default: $bool[$::opt_safer])
 
-Examples producing test.pdf:
+Examples all equivalently converting test.eps to test.pdf:
   \$ $program test.eps
   \$ cat test.eps | $program --filter >test.pdf
   \$ cat test.eps | $program -f -o=test.pdf
 
-Example to look for HiResBoundingBox and produce corrected PostScript:
-  \$ $program -d --nogs --hires test.ps >testcorr.ps
+Example for using HiResBoundingBox instead of BoundingBox:
+  \$ $program --hires test.eps
+
+Example for producing epstopdf's attempt at corrected PostScript:
+  \$ $program --nogs test.ps >testcorr.ps
+
+In all cases, you can add --debug (-d) to see more about what epstopdf
+is doing.
 
 More about the options for Ghostscript:
   Additional options to be used with gs can be specified
@@ -419,7 +430,7 @@ GetOptions (
   "gscmd=s",              # \ref{val_gscmd}
   "gsopt=s@",             # \ref{val_gsopt}
   "gsopts=s" => \&gsopts, # \ref{val_gsopts}
-  "help",
+  "help|h",
   "hires!",
   "outfile=s",            # \ref{openout_any}
   "pdfsettings=s",
@@ -428,7 +439,7 @@ GetOptions (
   "restricted",
   "safer!",
   "version",
-) or die $usage;
+) or die "Try $0 --help for more information\n";
 
 ### disable --quiet if option --debug is given
 $::opt_quiet = 0 if $::opt_debug;