summaryrefslogtreecommitdiff
path: root/support/pdfjam/README.md
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2023-05-12 03:02:23 +0000
committerNorbert Preining <norbert@preining.info>2023-05-12 03:02:23 +0000
commit23711a0fa219bf3164abd4aa2e25cb4db9757d7d (patch)
tree2ff6367ebc2164bcd857ce389e6221f2bf6f64a6 /support/pdfjam/README.md
parent9e4111819083b4794937d896ecb306c32daa1c2e (diff)
CTAN sync 202305120302
Diffstat (limited to 'support/pdfjam/README.md')
-rw-r--r--support/pdfjam/README.md37
1 files changed, 22 insertions, 15 deletions
diff --git a/support/pdfjam/README.md b/support/pdfjam/README.md
index 62f99b2ec5..cf7b248d49 100644
--- a/support/pdfjam/README.md
+++ b/support/pdfjam/README.md
@@ -1,11 +1,11 @@
-[![](https://travis-ci.com/DavidFirth/pdfjam.svg?branch=master)](https://travis-ci.com/DavidFirth/pdfjam)
+[![](https://travis-ci.com/rrthomas/pdfjam.svg?branch=master)](https://travis-ci.com/rrthomas/pdfjam)
# pdfjam
-_David Firth_ <https://warwick.ac.uk/dfirth>
+_Reuben Thomas_ <https://rrt.sc3d.org/>
A snapshot of this page is included as _README.md_
in the distributed package. The most up-to-date version is maintained online at
-<https://github.com/DavidFirth/pdfjam>.
+<https://github.com/rrthomas/pdfjam>.
1. [Overview](#overview)
- [What is pdfjam?](#whatis)
@@ -65,7 +65,7 @@ constructing more elaborate wrapper scripts as required.
Those 'wrapper' scripts are **no longer maintained**. I continue to make
them available in a separate repository
-<https://github.com/DavidFirth/pdfjam-extras>,
+<https://github.com/rrthomas/pdfjam-extras>,
in case anyone wants to see them, to use them, or to improve and maintain
them independently as a separate project.
@@ -81,7 +81,7 @@ at version 3.02 are:
- `pdfjam-slides3up`, `pdfjam-slides6up`
For those scripts and for more information on them, please now see
-<https://github.com/DavidFirth/pdfjam-extras>.
+<https://github.com/rrthomas/pdfjam-extras>.
# <a name="prereq"> Pre-requisites
@@ -120,7 +120,7 @@ that might change, so users are referred to the current
In case you want to look at the `pdfjam --help` text template online, for example
before you decide whether to install **pdfjam**, the source is available at
-<https://github.com/DavidFirth/pdfjam/blob/master/pdfjam-help.txt>.
+<https://github.com/rrthomas/pdfjam/blob/master/pdfjam-help.txt>.
There is also a (very basic) `man` page, accessed in the usual way
(after installation) by
@@ -143,7 +143,7 @@ _TeX Live_.
2. Install it yourself (e.g., if you don't want _TeX Live_, or if you want a later
release of **pdfjam** than the one that's currently in _TeX Live_).
Download the latest packaged release of **pdfjam** from
-<https://github.com/DavidFirth/pdfjam/releases>.
+<https://github.com/rrthomas/pdfjam/releases>.
If for some reason you don't want the latest released version, or even a recently released version, you can still get older versions too: see <https://davidfirth.github.io/pdfjam>.
**The first way, via _TeX Live_, is recommended** as the easiest way for most users.
@@ -172,7 +172,7 @@ temporary files, or a specific paper size for output PDFs ---
or some other reason.
The file
-[pdfjam.conf](https://github.com/DavidFirth/pdfjam/raw/master/pdfjam.conf)
+[pdfjam.conf](https://github.com/rrthomas/pdfjam/raw/master/pdfjam.conf)
is a sample configuration file which can be edited as needed. After editing,
either install the file for site-wide use (at `/etc/pdfjam.conf`,
`/usr/share/etc/pdfjam.conf`, `/usr/local/share/pdfjam.conf`, or
@@ -291,7 +291,7 @@ option is passed to LaTeX's `\includegraphics` command.
Slides made by LaTeX's _beamer_ package, using the `handout` class option,
work especially nicely with this! The example wrapper scripts `pdfjam-slides3up`
and `pdfjam-slides6up`, in the
-[pdfjam-extras](https://github.com/DavidFirth/pdfjam-extras) repository,
+[pdfjam-extras](https://github.com/rrthomas/pdfjam-extras) repository,
are for 3-up and 6-up handouts, respectively.
### Example 6: Trimming pages; and piped output
@@ -368,7 +368,7 @@ You could check also that `pdftex.def`, typically to be found in
is up to date. If the problem persists even with up-to-date versions of pdfTeX,
`pdftex.def` and pdfpages, then please do report it.
-**2. What can I do to solve a 'Too many open files' error?
+**2. What can I do to solve a 'Too many open files' error?**
This error has been reported to occur sometimes, when dealing with large numbers of
documents/pages. A suggested solution, if this happens,
@@ -386,7 +386,7 @@ for this suggestion and links to more information.
Please report any bugs found in `pdfjam`, either
-- by reporting as an issue at GitHub, <https://github.com/DavidFirth/pdfjam/issues>
+- by reporting as an issue at GitHub, <https://github.com/rrthomas/pdfjam/issues>
- by email (see <https://warwick.ac.uk/dfirth> for my email address)
### Some known problems:
@@ -430,20 +430,27 @@ so that people can still see and use/adapt them if they want.
And maybe even someone else will
want to take on the task of improving and maintaining some of them,
who knows? The wrapper scripts (**no longer maintained**) can now be found at
-<https://github.com/DavidFirth/pdfjam-extras>.
+<https://github.com/rrthomas/pdfjam-extras>.
### Version release notes
-[**3.03**](https://github.com/DavidFirth/pdfjam/releases/tag/v3.03) [2019-11-18]:
+[**3.04**](https://github.com/rrthomas/pdfjam/releases/tag/v3.04) [2023-05-07]:
+
+- Many documentation improvements.
+- Various minor code fixes.
+- No longer depend on hyperref package.
+- Support TMPDIR.
+
+[**3.03**](https://github.com/rrthomas/pdfjam/releases/tag/v3.03) [2019-11-18]:
- Built package now (again) has tests in a zip archive. (needed for CTAN)
-[**3.02**](https://github.com/DavidFirth/pdfjam/releases/tag/v3.02) [2019-11-14]:
+[**3.02**](https://github.com/rrthomas/pdfjam/releases/tag/v3.02) [2019-11-14]:
- Re-styled the package name to **pdfjam**. (Previously the package --- which then
contained several scripts --- was named PDFjam).
- Moved everything to a new home on the web at
- <a href="https://github.com/DavidFirth">github.com/DavidFirth</a>.
+ <a href="https://github.com/rrthomas">github.com/rrthomas</a>.
- Simplified the package by removal of all the 'wrapper' scripts
(`pdfnup`, `pdfjoin`, etc.).
- Settings specified via `--preamble` are now protected from the normal