summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pax
diff options
context:
space:
mode:
authorManuel Pégourié-Gonnard <mpg@elzevir.fr>2008-10-02 23:11:35 +0000
committerManuel Pégourié-Gonnard <mpg@elzevir.fr>2008-10-02 23:11:35 +0000
commita171ccb4029c7cb32b86229c0648b9a681acadf2 (patch)
tree5574a2d5bd387bc404fedcc1f681ab228994606a /Master/texmf-dist/doc/latex/pax
parentff02932b3376f298f236f229b8feb9a20ac71cc3 (diff)
pax update, v0.1i 2008/10/01
git-svn-id: svn://tug.org/texlive/trunk@10834 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/pax')
-rw-r--r--Master/texmf-dist/doc/latex/pax/README75
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.