summaryrefslogtreecommitdiff
path: root/Master/texmf/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-01-03 00:02:57 +0000
committerKarl Berry <karl@freefriends.org>2006-01-03 00:02:57 +0000
commit2d1de03dc193f01950d26edeacb21852f1b08bb9 (patch)
treef958602529de1e0f8d5943f5f42a3ba1d32621e0 /Master/texmf/doc
parentfade405932f7fce10c798bde3e33781ed7ca5dc6 (diff)
trunk/Master/texmf/doc/pdfcrop
git-svn-id: svn://tug.org/texlive/trunk@51 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc')
-rw-r--r--Master/texmf/doc/pdfcrop/README135
1 files changed, 135 insertions, 0 deletions
diff --git a/Master/texmf/doc/pdfcrop/README b/Master/texmf/doc/pdfcrop/README
new file mode 100644
index 00000000000..b16d5146290
--- /dev/null
+++ b/Master/texmf/doc/pdfcrop/README
@@ -0,0 +1,135 @@
+README for pdfcrop 2004/06/24 v1.5
+
+TABLE OF CONTENTS
+=================
+A. Description
+B. Copyright, Disclaimer, License
+C. Files
+D. Requirements
+E. Installation
+F. User Interface
+G. Author
+H. Acknowledgement
+I. Questions, Suggested Improvements
+J. Known Problems
+K. History
+L. ToDo
+
+A. DESCRIPTION
+==============
+PDFCROP takes a PDF file as input, calculates the BoundingBox
+for each page by the help of ghostscript and generates a output
+PDF file with removed margins.
+
+B. COPYRIGHT, DISCLAIMER, LICENSE
+=================================
+Copyright (C) 2002, 2004 Heiko Oberdiek.
+
+This program may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either version 1.2
+of this license or (at your option) any later version.
+The latest version of this license is in
+ http://www.latex-project.org/lppl.txt
+and version 1.2 or later is part of all distributions of LaTeX
+version 1999/12/01 or later.
+
+C. FILES
+========
+The project `pdfcrop' consists of two files:
+pdfcrop(.pl): This perl script is the main program. The extension
+ `.pl' may be omitted.
+README: Documentation, the file you are reading.
+
+Following temporary files are produced if `pdfcrop' is invoked:
+tmp-pdfcrop-*.tex: input file for pdfTeX
+tmp-pdfcrop-*.log: log file of pdfTeX run
+tmp-pdfcrop-*.pdf: result after pdfTeX run
+
+D. REQUIREMENTS
+===============
+* Perl5 (version 5 of the perl interpreter).
+* Ghostscript:
+* pdfTeX, version >= 1.0 (because of page selecting and \pdfximage syntax)
+* A unix like environement is needed (Unix, cygwin, ...).
+ The output of ghostscript's device bbox is written to STDERR, so
+ the script has to capture STDERR. Easy under Unix, but how this
+ can be done under DOS/Windows/...?
+
+E. INSTALLATION
+===============
+
+1. Perl script `pdfcrop.pl':
+
+ TDS 1.1 location:
+ * texmf/scripts/pdfcrop/pdfcrop.pl
+ * and a directory that is part of PATH contains a wrapper script
+ or link with name "pdfcrop".
+
+ Unix
+ * It is allowed to rename `pdfcrop.pl' to `pdfcrop':
+ mv pdfcrop.pl pdfcrop
+ * Ensure that the execute permission is set:
+ chmod +x pdfcrop
+ * Move the file to a directory where the shell can find it
+ (environment variable PATH, e.g. /usr/local/bin/).
+
+ Dos/Windows/(OS2)
+ * See requirements. I do not expect that the perl script
+ run under DOS or Windows. With cygwin it can work however.
+
+2. Documentation `README':
+
+ Copy it to an appropriate place, for example
+ `/usr/local/share/doc/pdfcrop/README'.
+ I is allowed to rename it to `pdfcrop.txt'.
+
+ TDS location:
+ somewhere below texmf/doc/... (?)
+
+F. USER INTERFACE
+=================
+* Online help:
+ pdfcrop --help
+
+G. AUTHOR
+=========
+Heiko Oberdiek
+Email: oberdiek@uni-freiburg.de
+
+H. ACKNOLEDGEMENT
+=================
+Anthony Williams
+Scott Pakin <pakin@uiuc.edu>
+
+I. QUESTIONS, SUGGESTED IMPROVEMENTS
+====================================
+If you have questions, problems with `pdfcrop', error reports,
+if you have improvements or want to have additional features,
+please send them to the author.
+
+My environment for developing and testing:
+* linux, SuSE 9.0
+* perl v5.8.1
+* pdfeTeX 3.141592-1.20a-2.1-rc2
+* Ghostscript 8.x
+
+J. KNOWN PROBLEMS
+=================
+
+K. HISTORY
+==========
+2002/10/30 v1.0: First release
+2002/10/30 v1.1: Option --hires added.
+2002/11/04 v1.2: "nul" instead of "/dev/null" for windows.
+2002/11/23 v1.3: Use of File::Spec module's "devnull" call.
+2002/11/29 v1.4: Option --papersize added.
+2004/06/24 v1.5: Clear map file entries so that pdfTeX
+ does not touch the fonts.
+
+L. TODO
+=======
+* Description of user interface.
+* Documentation in other formats, eg. man or info pages.
+* Improved error checking.
+* Units support for option --margins.
+* Perhaps other drivers than pdfTeX, especially VTeX.