diff options
Diffstat (limited to 'Master/texmf')
| -rw-r--r-- | Master/texmf/doc/pdfcrop/README | 135 |
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. |