pax update, v0.1i 2008/10/01

git-svn-id: svn://tug.org/texlive/trunk@10834 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 50 insertions, 25 deletions

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.