From ecf2098d020b68cab6c616cbfb1db074294a7617 Mon Sep 17 00:00:00 2001
From: Karl Berry <karl@freefriends.org>
Date: Wed, 22 Jul 2009 23:38:33 +0000
Subject: pdfcrop 1.18 (including rpdfcrop)

git-svn-id: svn://tug.org/texlive/trunk@14387 c570f23f-e606-0410-a88d-b1316a301751
---
 Master/texmf-dist/doc/support/pdfcrop/README | 66 +++++++++++++++++++++-------
 1 file changed, 51 insertions(+), 15 deletions(-)

(limited to 'Master/texmf-dist/doc/support/pdfcrop')

diff --git a/Master/texmf-dist/doc/support/pdfcrop/README b/Master/texmf-dist/doc/support/pdfcrop/README
index 9d47638d3f6..bdab822069e 100644
--- a/Master/texmf-dist/doc/support/pdfcrop/README
+++ b/Master/texmf-dist/doc/support/pdfcrop/README
@@ -1,4 +1,4 @@
-README for pdfcrop 2009/07/14 v1.15
+README for pdfcrop 2009/07/18 v1.18
 
 TABLE OF CONTENTS
 =================
@@ -8,12 +8,13 @@ C. Files
 D. Requirements
 E. Installation
 F. User Interface
-G. Author
-H. Acknowledgement
-I. Questions, Suggested Improvements
-J. Known Problems
-K. History
-L. ToDo
+G. Restricted Mode
+H. Author
+I. Acknowledgement
+J. Questions, Suggested Improvements
+K. Known Problems
+L. History
+M. ToDo
 
 A. DESCRIPTION
 ==============
@@ -73,7 +74,18 @@ E. INSTALLATION
    * See requirements. I do not expect that the perl script
      run under DOS.
 
-2. Documentation `README':
+2. Restricted program version `rpdfcrop'
+
+   Generate links or install `pdfcrop.pl' again under the
+   name `rpdfcrop'.
+
+   Prefer `rpdfcrop' if you want to add pdfcrop to the
+   programs that may be executed in TeX's restricted
+   shell escape mode. (This feature is added in TeX Live 2009.)
+   For TeX Live (since 2009) see entry for `shell_escape_commands'
+   in the configuration file `texmf.cnf'.
+
+3. Documentation `README':
 
    Copy it to an appropriate place, for example
    `/usr/local/share/doc/pdfcrop/README'.
@@ -99,12 +111,27 @@ F. USER INTERFACE
   Of course the calculation with higher resolution settings are
   more accurate.
 
-G. AUTHOR
+G. RESTRICTED MODE
+==================
+Restricted mode is enabled if:
+* option `--restricted' is used,
+* the program is called under the name `rpdfcrop'
+* or the called program name contains `restricted'.
+This mode sets restrictions for the following options:
+* --pdftexcmd: if used, the value must be empty or `pdftex'.
+* --xetexcmd: if used, the value must be empty or `xetex'.
+* --gscmd: if used, the value must
+  * be empty or
+  * be one of the standard names (gs, gswin32c, mgs, gs386 gsos2) or
+  * consists of `gs', followed by a version number and an
+    optional `c' (Ghostscript's convention for `console version').
+
+H. AUTHOR
 =========
 Heiko Oberdiek
 Email: oberdiek at uni-freiburg.de
 
-H. ACKNOWLEDGEMENT
+I. ACKNOWLEDGEMENT
 ==================
 Anthony Williams
 Scott Pakin <pakin at uiuc.edu>
@@ -114,7 +141,7 @@ R (Chandra) Chandrasekhar
 Christian Stapfer
 David Menestrina
 
-I. QUESTIONS, SUGGESTED IMPROVEMENTS
+J. QUESTIONS, SUGGESTED IMPROVEMENTS
 ====================================
 If you have questions, problems with `pdfcrop', error reports,
 if you have improvements or want to have additional features,
@@ -126,14 +153,14 @@ My environment for developing and testing:
 * pdfTeX 3.141592-1.40.x
 * Ghostscript 8.x
 
-J. KNOWN PROBLEMS
+K. KNOWN PROBLEMS
 =================
 * pdfcrop relies on Ghostscript for the calculation of the
   Bounding Box. If Ghostscript returns wrong values or
   cannot process the pdf file, it sometimes helps to try
   another version of Ghostscript.
 
-K. HISTORY
+L. HISTORY
 ==========
 2002/10/30 v1.0:  First release
 2002/10/30 v1.1:  Option --hires added.
@@ -158,8 +185,17 @@ K. HISTORY
 2008/09/12 v1.14: Error detection for invalid Bounding Boxes.
 2009/07/14 v1.15: Fix for negative coordinates in Bounding Boxes
                   (David Menestrina).
-
-L. TODO
+2009/07/17 v1.16: Security fixes:
+                  * -dSAFER added for Ghostscript,
+                  * -no-shell-escape added for pdfTeX/XeTeX.
+2009/07/17 v1.17: Security fixes:
+                  * Backticks and whitespace are forbidden
+                    for options --(gs|pdftex|xetex)cmd.
+                  * Validation of options --papersize and --resolution.
+2009/07/18 v1.18: * Restricted mode added.
+                  * Option --version added.
+
+M. TODO
 =======
 * Description of user interface.
 * Documentation in other formats, eg. man or info pages.
-- 
cgit v1.2.3