epstopdf (13may13)

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

1 files changed, 15 insertions, 9 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.