summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-04-30 18:17:54 +0000
committerKarl Berry <karl@freefriends.org>2010-04-30 18:17:54 +0000
commit5cc722828d1314a5cb3aaf9c00f2f7cad1988c95 (patch)
treeed4d66c4b46433779ee208db6d5af7b3b3e85b40 /Master/texmf-dist/doc/latex
parent0e290b30838946f452aa3ea2fd58654e9cc68b1e (diff)
pdfjam update
git-svn-id: svn://tug.org/texlive/trunk@18056 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r--Master/texmf-dist/doc/latex/pdfjam/PDFjam-README.html37
-rw-r--r--Master/texmf-dist/doc/latex/pdfjam/VERSION2
-rw-r--r--Master/texmf-dist/doc/latex/pdfjam/pdfjam.conf6
-rw-r--r--Master/texmf-dist/doc/latex/pdfjam/tests.zipbin0 -> 120866 bytes
4 files changed, 35 insertions, 10 deletions
diff --git a/Master/texmf-dist/doc/latex/pdfjam/PDFjam-README.html b/Master/texmf-dist/doc/latex/pdfjam/PDFjam-README.html
index 7f3a44b711b..14de2cd43f6 100644
--- a/Master/texmf-dist/doc/latex/pdfjam/PDFjam-README.html
+++ b/Master/texmf-dist/doc/latex/pdfjam/PDFjam-README.html
@@ -10,7 +10,6 @@
<p><em>Author</em>: David Firth, <a href="http://go.warwick.ac.uk/dfirth">http://go.warwick.ac.uk/dfirth</a></p>
<p> <strong> This file is kept up to date at <a href="http://go.warwick.ac.uk/pdfjam">http://go.warwick.ac.uk/pdfjam</a>. </strong> </p>
-
<ul>
<li><a href="#overview">Overview</a> </li>
<li><a href="#prereq">Pre-requisites</a> </li>
@@ -47,7 +46,7 @@
<p> A potential drawback of <tt>pdfjam</tt> and other scripts based upon it is that any hyperlinks in the source PDF are lost. On the positive side, there is no appreciable degradation of image quality in processing PDF files with these programs, unlike some other indirect methods such as&nbsp; <tt>pdf2ps | psnup | ps2pdf</tt> &nbsp;(in the author's experience). </p>
-<p> These tools are designed for Unix-like systems, including Linux and Mac OS X. It seems that they will work also on Windows computers with a suitable installation of <a href="http://www.cygwin.com/">Cygwin</a>, but this has not been extensively tested.</p>
+<p> These tools are designed for Unix-like systems, including Linux and Mac OS X. It seems that they will work also on Windows computers with a suitable installation of <a href="http://www.cygwin.com/">Cygwin</a> (with the Cygwin <tt>tetex-extras</tt> package installed), but this has not been extensively tested.</p>
<p> An alternative set of PDF manipulation tools, which are java-based, is provided by the <a href="http://multivalent.sourceforge.net/">Multivalent</a> project. They do much the same things as <tt>pdfjam</tt>, and quite a bit more. Hyperlinks don't seem to be preserved there either, though, when n-upping a document. </p>
@@ -83,13 +82,21 @@
<a name="download"></a> <h2 align="justify">Download</h2>
-<p>Download the shell scripts as <a href="http://www2.warwick.ac.uk/fac/sci/statistics/staff/academic/firth/software/pdfjam/pdfjam_2.01.tgz">pdfjam_2.01.tgz</a>. </p>
+<p>PDFjam is a project at <a href="http://freshmeat.net/projects/pdfjam/">freshmeat</a>: please subscribe there to receive update announcements. <a name="install"></a>Download the shell scripts as <a href="http://www2.warwick.ac.uk/fac/sci/statistics/staff/academic/firth/software/pdfjam/pdfjam_latest.tgz">pdfjam_latest.tgz</a>. </p>
+
+<p>(If for some reason you don't want the latest version, you can still get older versions. Since version 2.00 the URLs are all of the form <tt>http://go.warwick.ac.uk/pdfjam/pdfjam_VN.tgz</tt>, with &quot;VN&quot; representing the version number. So &quot;VN&quot; could be 2.00, 2.01, 2.02, 2.03 or 2.04; from PDFjam version 2.05 onwards, the dot will be omitted from the file name, so &quot;VN&quot; will be 205, 206, etc.)</p>
-<p> Eduard Bloch has kindly packaged <a href="http://packages.debian.org/unstable/text/pdfjam">PDFjam for Debian</a>. Paul Chvostek has kindly made a <a href="http://www.freebsd.org/cgi/ports.cgi?query=pdfjam">port to FreeBSD</a>. Pander has kindly provided a link to <a href="http://packages.ubuntu.com/search?keywords=pdfjam">Ubuntu packages</a>. Petr Uzel has kindly made available <a href="http://software.opensuse.org/search?baseproject=ALL&amp;p=1&amp;q=pdfjam">openSUSE packages</a>.</p>
+<p>Various people have kindly packaged PDFjam for distribution in other ways (and perhaps there are some not listed here?): </p>
-<p> For some Mac OS X droplets (based on PDFjam version 1.21), see <a href="#droplets">below</a>. </p>
+<ul>
+ <li>Eduard Bloch has packaged <a href="http://packages.debian.org/unstable/text/pdfjam">PDFjam for Debian</a> </li>
+ <li>Paul Chvostek has made a <a href="http://www.freebsd.org/cgi/ports.cgi?query=pdfjam">port to FreeBSD</a> </li>
+ <li>Pander has provided a link to <a href="http://packages.ubuntu.com/search?keywords=pdfjam">Ubuntu packages</a> </li>
+ <li>Petr Uzel has made available <a href="http://software.opensuse.org/search?baseproject=ALL&amp;p=1&amp;q=pdfjam">openSUSE packages</a> </li>
+ <li>Karl Berry has kindly provided a <a href="http://mirror.ctan.org/support/pdfjam">CTAN package</a>.</li>
+</ul>
-<p> PDFjam is a project at <a href="http://freshmeat.net/projects/pdfjam/">freshmeat</a>: please subscribe there to receive update announcements. <a name="install"></a> </p>
+<p> To download some stand-alone <em>Mac OS X droplets</em> (based on PDFjam version 1.21), see <a href="#droplets">below</a>. </p>
<a name="install"></a><h2 align="justify">Installation/configuration</h2>
@@ -97,7 +104,7 @@
<p>The man files in the <em>man1</em> sub-directory should be installed on the <tt>MANPATH</tt> of all who need to read them.</p>
-<p> On many unix-like systems the scripts should run without any further configuration, provided that the pre-requisite TeX installation is present. </p>
+<p> On many unix-like systems the scripts should run without any further configuration, provided that the pre-requisite TeX installation is present. If you want to check (e.g., prior to installation) that <tt>pdfjam</tt> will work on your system, please unzip the <em>tests</em> sub-directory of the package and follow the instructions that appear in <tt>tests/README-tests.txt</tt>.</p>
<p>If configuration <em>is</em> needed, this can be done through a site-wide or user-specific configuration file. This might be necessary if, for example, your site has a non-standard TeX installation, or a non-standard location for temporary files, or a paper size that is different from the A4 international standard.</p>
@@ -250,8 +257,24 @@ pdflatex=/path/to/pdflatex
<p>Please report any bugs found in these scripts, to d.firth (at warwick.ac.uk).</p>
+<h3>Some known problems:</h3>
+
+<ul>
+ <li> Use of <tt>pdfjam</tt> in a pipeline does not seem to work in <em>Cygwin</em>. Scripts like <tt>pdfjam-pocketmod</tt>, which use pipelines, therefore do not work there. The problem seems to be with <em>Cygwin</em>'s handling of file descriptors with pipelines.</li>
+</ul>
+
+<p>Solving these problems is on the to-do list: if you have solved one of them already please let me know!</p>
+
<a name="history"></a> <h2 align="justify">Version history</h2>
+<p> <strong>2.05</strong>: changes to the <tt>pdfbook</tt> script &mdash; the <tt>--right-edge-binding</tt> option is now redundant, and there's a new <tt>--short-edge</tt> option for binding along the short edge of pages instead of the long edge (thanks to Marco Pessotto for this). The <tt>--preamble</tt> option to <tt>pdfjam</tt> is enhanced, to allow multiple instances which get concatenated. Also various minor corrections to man pages. [2010-04-25] </p>
+
+<p> <strong>2.04</strong>: various minor improvements suggested by Debian maintainers (thanks to Eduard Bloch for these). The main things are: addition of the <tt>--version</tt> option; liberalisation of <tt>pdfjam</tt> to allow files in <em>JPEG</em> format to be specified as input, as well as PDF (I don't know why or if this might work! but some people have said it does); tidying of the man files; and more use of <tt>exec</tt>, to avoid forking. [2010-04-22] </p>
+
+<p> <strong>2.03</strong>: fixed a bug which caused problems when your <tt>/bin/sh</tt> is the <em>zsh</em> shell; fixed a bug which prevented the correct representation of many UTF-8 characters in <tt>pdfinfo</tt> data. [2010-04-20] </p>
+
+<p> <strong>2.02</strong>: more progress on portability; introduced the beginnings of a suite of tests; improvements in the <tt>--keepinfo</tt> functionality, and in the treatment of file permissions (thanks to Marco Pessotto for these). [2010-04-14] </p>
+
<p> <strong>2.01</strong>: fixed a silly bug (thoughtless use of &quot;<tt>test -a</tt>&quot; in a couple of places) which seriously affected portability. [2010-04-13] </p>
<hr color="grey" />
diff --git a/Master/texmf-dist/doc/latex/pdfjam/VERSION b/Master/texmf-dist/doc/latex/pdfjam/VERSION
index d507853e573..793cf9a340d 100644
--- a/Master/texmf-dist/doc/latex/pdfjam/VERSION
+++ b/Master/texmf-dist/doc/latex/pdfjam/VERSION
@@ -1 +1 @@
-This is PDFjam 2.01 \ No newline at end of file
+This is PDFjam 2.05 \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/pdfjam/pdfjam.conf b/Master/texmf-dist/doc/latex/pdfjam/pdfjam.conf
index dbebf73ce67..9b8f90c12e1 100644
--- a/Master/texmf-dist/doc/latex/pdfjam/pdfjam.conf
+++ b/Master/texmf-dist/doc/latex/pdfjam/pdfjam.conf
@@ -70,8 +70,8 @@ paper='a4paper' ## for ISO A4 paper
## DEFAULT PATH FOR THE --outfile OPTION
##
outFile="$pwd" ## the obvious default
-# outFile="$HOME/Documents" ## another possibility, perhaps
-# outFile=/dev/stdout ## for easy pipes
+# outFile="$HOME/Documents" ## (another possibility, perhaps)
+# outFile=/dev/stdout ## (for easy pipes)
##
###############################################################
##
@@ -87,5 +87,7 @@ landscape='false' ## overridden by '--landscape' in the call
twoside='false' ## overridden by '--twoside' in the call
# twoside='true' ## the alternative
##
+preamble='' ## concatenate other strings to this by using '--preamble'
+##
###############################################################
## END OF FILE: that's all you can configure here!
diff --git a/Master/texmf-dist/doc/latex/pdfjam/tests.zip b/Master/texmf-dist/doc/latex/pdfjam/tests.zip
new file mode 100644
index 00000000000..2f4b644de5d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfjam/tests.zip
Binary files differ