epstopdf (13may13)

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

5 files changed, 41 insertions, 24 deletions

diff --git a/Build/source/texk/texlive/linked_scripts/epstopdf/epstopdf.pl b/Build/source/texk/texlive/linked_scripts/epstopdf/epstopdf.pl
index 31dd47459e2..8df3a73351c 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 26570 2012-05-22 16:14:37Z karl $
+# $Id: epstopdf.pl 30419 2013-05-12 17:55:50Z karl $
 # (Copyright lines below.)
 #
 # Redistribution and use in source and binary forms, with or without
@@ -43,6 +43,8 @@
 #
 # emacs-page
 # History
+#  2013/05/12 v2.19 (Karl Berry)
+#    * explain option naming conventions (= defaults for Getopt::Long).
 #  2012/05/22 v2.18 (Karl Berry)
 #    * use /usr/bin/env, since Ruby has apparently required #! for years,
 #      and we rely on it for our other scripts, so why not.
@@ -154,9 +156,9 @@
 
 ### program identification
 my $program = "epstopdf";
-my $ident = '($Id: epstopdf.pl 26570 2012-05-22 16:14:37Z karl $) 2.18';
+my $ident = '($Id: epstopdf.pl 30419 2013-05-12 17:55:50Z karl $) 2.19';
 my $copyright = <<END_COPYRIGHT ;
-Copyright 2009-2012 Karl Berry et al.
+Copyright 2009-2013 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>
@@ -215,18 +217,22 @@ Options:
   --gscmd=VAL        pipe output to VAL    (default: $GS)
   --res=DPI          set image resolution  (default: $resmsg)
   --autorotate=VAL   set AutoRotatePages   (default: $rotmsg)
-                      Recognized VAL choices: None, All, PageByPage
-                      For EPS files, PageByPage is equivalent to All
+                      Recognized VAL choices: None, All, PageByPage;
+                      for EPS files, PageByPage is equivalent to All.
   --restricted       use restricted mode   (default: $bool[$restricted])
 
-Examples producing test.pdf:
+Examples all equivalently producing test.pdf:
   * $program test.eps
-  * produce postscript | $program --filter >test.pdf
-  * produce postscript | $program -f -d -o=test.pdf
+  * cat test.eps | $program --filter >test.pdf
+  * cat test.eps | $program -f -o=test.pdf
 
-Example: look for HiResBoundingBox and produce corrected PostScript:
+Example to look for HiResBoundingBox and produce corrected PostScript:
   * $program -d --nogs --hires test.ps >testcorr.ps
 
+Options may start with either - or --, and may be unambiguously
+abbreviated.  It is best to use the full option name in scripts, though,
+to avoid possible collisions with new options in the future.
+
 When reporting bugs, please include an input file and command line
 options so the problem can be reproduced.
 
diff --git a/Master/texmf-dist/doc/man/man1/epstopdf.1 b/Master/texmf-dist/doc/man/man1/epstopdf.1
index ac57d1dc7d2..1669e624899 100644
--- a/Master/texmf-dist/doc/man/man1/epstopdf.1
+++ b/Master/texmf-dist/doc/man/man1/epstopdf.1
@@ -1,5 +1,5 @@
-.TH EPSTOPDF 1 "18 March 2010"
-.\" $Id: epstopdf.1 18160 2010-05-09 00:02:00Z karl $
+.TH EPSTOPDF 1 "12 May 2013"
+.\" $Id: epstopdf.1 30418 2013-05-12 17:54:12Z karl $
 .SH NAME
 epstopdf, repstopdf \- convert an EPS file to PDF
 .SH SYNOPSIS
@@ -14,6 +14,11 @@ result is piped to Ghostscript and a PDF version written.
 .P
 If the bounding box is not right, of course, there are problems.
 .SH OPTIONS
+Options may start with either "\fB-\fP" or "\fB--\fP", and may be
+unambiguously abbreviated.  (It is best to use the full option name in
+scripts, though, to avoid possible collisions with new options in the
+future.)
+.PP
 .IP "\fB--outfile\fP=\fIfile\fP"
 write result to \fIfile\fP.  If this option is not given, and
 \fB--nogs\fP or \fB--filter\fP is specified, write to standard output;
@@ -53,13 +58,13 @@ display help message and exit
 .IP "\fB--version\fP
 display version information and exit
 .SH EXAMPLES
-Examples which produce "test.pdf":
+Examples all equivalently producing "test.pdf":
 .nf
 epstopdf test.eps
-produce postscript | epstopdf --filter >test.pdf
-produce postscript | epstopdf -f -d -o=test.pdf
+cat test.eps | epstopdf --filter >test.pdf
+cat test.eps | epstopdf -f -d -o=test.pdf
 .fi
-Example: look for HiresBoundingBox and produce corrected PostScript:
+Example to look for HiResBoundingBox and produce corrected PostScript:
 .nf
 epstopdf -d --nogs --hires test.ps >testcorr.ps 
 .fi
diff --git a/Master/texmf-dist/doc/man/man1/epstopdf.man1.pdf b/Master/texmf-dist/doc/man/man1/epstopdf.man1.pdf
index 0bb18287ca9..3edbee7732a 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 b0a69c9b507..04a3a5e1c2f 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/scripts/epstopdf/epstopdf.pl b/Master/texmf-dist/scripts/epstopdf/epstopdf.pl
index 31dd47459e2..8df3a73351c 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 26570 2012-05-22 16:14:37Z karl $
+# $Id: epstopdf.pl 30419 2013-05-12 17:55:50Z karl $
 # (Copyright lines below.)
 #
 # Redistribution and use in source and binary forms, with or without
@@ -43,6 +43,8 @@
 #
 # emacs-page
 # History
+#  2013/05/12 v2.19 (Karl Berry)
+#    * explain option naming conventions (= defaults for Getopt::Long).
 #  2012/05/22 v2.18 (Karl Berry)
 #    * use /usr/bin/env, since Ruby has apparently required #! for years,
 #      and we rely on it for our other scripts, so why not.
@@ -154,9 +156,9 @@
 
 ### program identification
 my $program = "epstopdf";
-my $ident = '($Id: epstopdf.pl 26570 2012-05-22 16:14:37Z karl $) 2.18';
+my $ident = '($Id: epstopdf.pl 30419 2013-05-12 17:55:50Z karl $) 2.19';
 my $copyright = <<END_COPYRIGHT ;
-Copyright 2009-2012 Karl Berry et al.
+Copyright 2009-2013 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>
@@ -215,18 +217,22 @@ Options:
   --gscmd=VAL        pipe output to VAL    (default: $GS)
   --res=DPI          set image resolution  (default: $resmsg)
   --autorotate=VAL   set AutoRotatePages   (default: $rotmsg)
-                      Recognized VAL choices: None, All, PageByPage
-                      For EPS files, PageByPage is equivalent to All
+                      Recognized VAL choices: None, All, PageByPage;
+                      for EPS files, PageByPage is equivalent to All.
   --restricted       use restricted mode   (default: $bool[$restricted])
 
-Examples producing test.pdf:
+Examples all equivalently producing test.pdf:
   * $program test.eps
-  * produce postscript | $program --filter >test.pdf
-  * produce postscript | $program -f -d -o=test.pdf
+  * cat test.eps | $program --filter >test.pdf
+  * cat test.eps | $program -f -o=test.pdf
 
-Example: look for HiResBoundingBox and produce corrected PostScript:
+Example to look for HiResBoundingBox and produce corrected PostScript:
   * $program -d --nogs --hires test.ps >testcorr.ps
 
+Options may start with either - or --, and may be unambiguously
+abbreviated.  It is best to use the full option name in scripts, though,
+to avoid possible collisions with new options in the future.
+
 When reporting bugs, please include an input file and command line
 options so the problem can be reproduced.