summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/pdfcrop
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-07-22 23:38:33 +0000
committerKarl Berry <karl@freefriends.org>2009-07-22 23:38:33 +0000
commitecf2098d020b68cab6c616cbfb1db074294a7617 (patch)
tree5a274642e1e1b90e80dd5cbc21e6437ed84bfd7f /Master/texmf-dist/doc/support/pdfcrop
parent53be938673b1df4c4007eeafebbd8b23bf97ac59 (diff)
pdfcrop 1.18 (including rpdfcrop)
git-svn-id: svn://tug.org/texlive/trunk@14387 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support/pdfcrop')
-rw-r--r--Master/texmf-dist/doc/support/pdfcrop/README66
1 files changed, 51 insertions, 15 deletions
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.