From a171ccb4029c7cb32b86229c0648b9a681acadf2 Mon Sep 17 00:00:00 2001 From: Manuel Pégourié-Gonnard Date: Thu, 2 Oct 2008 23:11:35 +0000 Subject: pax update, v0.1i 2008/10/01 git-svn-id: svn://tug.org/texlive/trunk@10834 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/pax/README | 75 ++++++++++++++++++++++------------ 1 file changed, 50 insertions(+), 25 deletions(-) (limited to 'Master/texmf-dist/doc/latex/pax') diff --git a/Master/texmf-dist/doc/latex/pax/README b/Master/texmf-dist/doc/latex/pax/README index 03e070a9853..a7bed4d701c 100644 --- a/Master/texmf-dist/doc/latex/pax/README +++ b/Master/texmf-dist/doc/latex/pax/README @@ -1,4 +1,4 @@ -README for project pax (PDFAnnotExtractor), 2007/07/19 v0.1h +README for project pax (PDFAnnotExtractor), 2008/10/01 v0.1i TABLE OF CONTENTS @@ -33,10 +33,11 @@ Project status: experimental B. COPYRIGHT, LICENSE ===================== -Copyright (C) 2006, 2007 Heiko Oberdiek. +Copyright (C) 2006-2008 Heiko Oberdiek. The project consists of two parts: * The Java program pax.jar with sources. + The Perl wrapper pdfannotextractor.pl. License is GPL, see license/gpl.txt. * The LaTeX package pax.sty. License is LPPL 1.3. @@ -63,6 +64,8 @@ The files inside pax-tds.zip: This file. * scripts/pax/pax.jar The Java program. +* scripts/pax/pdfannotextractor.pl + Perl wrapper for calling the Java program in pax.jar. * source/latex/pax/license/LaTeX/lppl.txt License (LPPL) for the LaTeX package. * source/latex/pax/license/PDFAnnotExtractor/gpl.txt @@ -91,6 +94,15 @@ E. REQUIREMENTS * Java 1.4+. * PDFBox 0.7.2+. +* The Perl wrapper (optional) needs: + * Perl + * kpsewhich + * java in PATH + The option --install also requires: + * wget or curl + * unzip + * texhash or mktexlsr + F. DOWNLOAD =========== @@ -98,44 +110,53 @@ F. DOWNLOAD 1. Download pax-tds.zip from CTAN: ftp://ftp.ctan.org/tex-archive/macros/latex/contrib/pax/pax-tds.zip -2. Download PDFBox-0.7.2.jar from http://www.pdfbox.org/: - http://prdownloads.sourceforge.net/pdfbox/PDFBox-0.7.2.zip?download +2. Download PDFBox-0.7.3.jar from http://www.pdfbox.org/ (22 MB) + http://prdownloads.sourceforge.net/pdfbox/PDFBox-0.7.3.zip?download + Or install PDFBox as RPM package or whatever. + G. INSTALLATION =============== Examples are given for linux. -3. Install PDFBox. In the following it is assumed, that the JAR file - is available as: - /usr/local/share/PDFBox-0.7.2/lib/PDFBox-0.7.2.jar +3. Install PDFBox (from its home page, RPM package, ...). + The wrapper pdfannotextractor.pl looks for the JAR file in directories: + /usr/share/java/ + /usr/local/share/java/ + TDS:scripts/pax/lib/ (TDS:scripts//) + assuming one of the following names: + pdfbox.jar + PDFBox.jar + pdfbox-0.7.3.jar + PDFBox-0.7.3.jar + pdfbox-0.7.2.jar + PDFBox-0.7.2.jar + +Alternative for 2. and 3. + * Continue with 4. and 5.a). + * Call `pdfannotextractor --install' (or with option --debug). + It downloads PDFBox from its homepage and installs it + in TEXMFVAR(VARTEXMF) below TDS:scripts/pax/ 4. Unzip pax-tds.zip inside the TDS tree, where you want to put this project, e.g.: unzip pax-tds -d /usr/local/share/texmf Don't forget to update the database (texhash, mktexlsr, ...). -5. Put the PDFBox library in the right place: - mkdir /usr/local/share/texmf/scripts/pax/lib - ln /usr/local/share/PDFBox-0.7.2/lib/PDFBox-0.7.2.jar \ - /usr/local/share/texmf/scripts/pax/lib/ - (A symbol link does not seam to work, a hard link or copy is needed.) - Alternatively, include PDFBox-0.7.2.jar in your CLASSPATH and/or - adjust the Class-Path entry in MANIFEST.MF of pax.jar for the - right location of the PDFBox library. - -6. Write a wrapper script or whatever to ease the call of the - Java program, e.g.: - #!/bin/sh - java -jar /usr/local/share/texmf/scripts/pax/pax.jar "$@" +5.a) Install the wrapper Perl script pdfannotextractor.pl + as `pdfannotextractor' somewhere in your PATH (/usr/local/bin, + /usr/bin, ...). +5.b) Or write a wrapper script or whatever to ease the call of the + Java program, e.g.: + #!/bin/sh + java -cp pax.jar:pdfbox.jar pax.PDFAnnotExtractor "$@" Version of PDFBox ----------------- -Developing the pax project I have used and tested version 0.7.2. -However, you may try a more uptodate version of PDFBox. -Then fix the entry in the file MANIFEST.MF inside pax.jar or -create a symbol link that TDS:scripts/pax/lib/PDFBox-0.7.2.jar -points to the new JAR file. +Developing the pax project I have used and tested version 0.7.2, +also the current version 0.7.3 seems to be fine. Older versions +are not supported at all, they may work or do not. H. USE @@ -206,3 +227,7 @@ I. History * Compiled for Java 1.4. 2007/07/19 v0.1h * JAR file without TDS tree. +2008/10/01 v0.1i + * Perl wrapper `pdfannotextractor.pl' added. + * Section `Installation' from README rewritten. + * Class-Path removed from MANIFEST.MF. -- cgit v1.2.3