From ecf2098d020b68cab6c616cbfb1db074294a7617 Mon Sep 17 00:00:00 2001 From: Karl Berry 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') 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 @@ -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