summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2024-06-13 20:15:25 +0000
committerKarl Berry <karl@freefriends.org>2024-06-13 20:15:25 +0000
commit95e8a1f4641bd5dbb0a14bf499ddb18ef5efa6f8 (patch)
treedc59e62d1b8d655061d9c816d05156ce7980c76b /Master/texmf-dist/doc
parent7ba522a8344a0069fd4429fb2c929d8a3d63ae69 (diff)
pdfxup (13jun24)
git-svn-id: svn://tug.org/texlive/trunk@71513 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/man/man1/pdfxup.12
-rw-r--r--Master/texmf-dist/doc/man/man1/pdfxup.man1.pdfbin28280 -> 28364 bytes
-rw-r--r--Master/texmf-dist/doc/support/pdfxup/README4
-rw-r--r--Master/texmf-dist/doc/support/pdfxup/RELEASES4
-rw-r--r--Master/texmf-dist/doc/support/pdfxup/doc/Makefile3
-rw-r--r--Master/texmf-dist/doc/support/pdfxup/doc/pdfxup-doc.pdf (renamed from Master/texmf-dist/doc/support/pdfxup/pdfxup.pdf)bin90128 -> 94798 bytes
-rw-r--r--Master/texmf-dist/doc/support/pdfxup/doc/pdfxup-doc.tex163
-rw-r--r--Master/texmf-dist/doc/support/pdfxup/doc/pdfxup.pdfbin0 -> 96697 bytes
8 files changed, 173 insertions, 3 deletions
diff --git a/Master/texmf-dist/doc/man/man1/pdfxup.1 b/Master/texmf-dist/doc/man/man1/pdfxup.1
index 8ca0c2b394a..49851a17f0b 100644
--- a/Master/texmf-dist/doc/man/man1/pdfxup.1
+++ b/Master/texmf-dist/doc/man/man1/pdfxup.1
@@ -1,6 +1,6 @@
.\" Manpage for pdfxup.
.\" Contact pdfxup@markey.fr to correct errors or typos.
-.TH man 1 "24 april 2021" "2.10" "pdfxup man page"
+.TH man 1 "11 june 2024" "2.12" "pdfxup man page"
.SH NAME
pdfxup \- n-up tool with reduced margins
.SH SYNOPSIS
diff --git a/Master/texmf-dist/doc/man/man1/pdfxup.man1.pdf b/Master/texmf-dist/doc/man/man1/pdfxup.man1.pdf
index ee969aeab10..cb37cc77b65 100644
--- a/Master/texmf-dist/doc/man/man1/pdfxup.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/pdfxup.man1.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/pdfxup/README b/Master/texmf-dist/doc/support/pdfxup/README
index 335ae71dd88..7bbb705d4c6 100644
--- a/Master/texmf-dist/doc/support/pdfxup/README
+++ b/Master/texmf-dist/doc/support/pdfxup/README
@@ -1,4 +1,4 @@
-PDFXUP -- v2.11 (2024/03/15)
+PDFXUP -- v2.12 (2024/06/11)
N. Markey <pdfxup@markey.fr>
@@ -18,7 +18,7 @@ graphicx package) in order to produce the new document.
-%% (c) 2024/03/15 Nicolas Markey <pdfxup at markey dot fr>
+%% (c) 2024/06/11 Nicolas Markey <pdfxup at markey dot fr>
%%
%% This work may be distributed and/or modified under the conditions of
%% the LaTeX Project Public License, either version 1.3 of this license
diff --git a/Master/texmf-dist/doc/support/pdfxup/RELEASES b/Master/texmf-dist/doc/support/pdfxup/RELEASES
index b6272603a33..f0e9b936432 100644
--- a/Master/texmf-dist/doc/support/pdfxup/RELEASES
+++ b/Master/texmf-dist/doc/support/pdfxup/RELEASES
@@ -65,3 +65,7 @@ v2.10 (2021/04/25)
v2.11 (2024/03/15)
- fixed a bug in testdim, which did not support fractional values
(bug reported by Walt Tuvell)
+
+v2.12 (2024/06/11)
+ - fixed several bugs related with page ranges (bugs reported by
+ Sanjoy Mahajan)
diff --git a/Master/texmf-dist/doc/support/pdfxup/doc/Makefile b/Master/texmf-dist/doc/support/pdfxup/doc/Makefile
new file mode 100644
index 00000000000..ea9fe01b2fb
--- /dev/null
+++ b/Master/texmf-dist/doc/support/pdfxup/doc/Makefile
@@ -0,0 +1,3 @@
+all:
+ pdflatex pdfxup-doc.tex
+ pdfxup -o pdfxup.pdf pdfxup-doc.pdf
diff --git a/Master/texmf-dist/doc/support/pdfxup/pdfxup.pdf b/Master/texmf-dist/doc/support/pdfxup/doc/pdfxup-doc.pdf
index 2c629a8b2ef..cf3f9af9365 100644
--- a/Master/texmf-dist/doc/support/pdfxup/pdfxup.pdf
+++ b/Master/texmf-dist/doc/support/pdfxup/doc/pdfxup-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/pdfxup/doc/pdfxup-doc.tex b/Master/texmf-dist/doc/support/pdfxup/doc/pdfxup-doc.tex
new file mode 100644
index 00000000000..c051d0483f5
--- /dev/null
+++ b/Master/texmf-dist/doc/support/pdfxup/doc/pdfxup-doc.tex
@@ -0,0 +1,163 @@
+\documentclass{article}
+\usepackage[margin=6cm]{geometry}
+\usepackage{tikz}
+\usepackage{xspace}
+\def\pdfxup{\texttt{pdfxup}\xspace}
+
+\begin{document}
+\title{\pdfxup \\[2mm]
+ \normalsize
+ version 2.12 -- 2024/06/11}
+\author{Nicolas Markey}
+\date{}
+
+\maketitle
+
+\def\abstractname{}
+\begin{abstract}
+\pdfxup is a shell script that creates $n$-up PDF documents, while at
+the same time removing as much white stripes as possible. This
+document reviews the main features of \pdfxup. See the \verb+man+ page
+for more details.
+\end{abstract}
+
+\section{Basic usage}
+Running \pdfxup with no options creates a 2-up document from the
+original PDF file:
+\begin{center}
+\begin{tikzpicture}[scale=1.5]
+ \begin{scope}
+ \draw (0,0) |- (1.1,1.5) |- cycle;
+ \foreach \x in {.3,.4,...,.9}
+ {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);}
+ \draw [line width=.5mm,black!50!white] (.3,1.1) -- +(.5,0);
+ \end{scope}
+ \begin{scope}[xshift=1.2cm]
+ \draw (0,0) |- (1.1,1.5) |- cycle;
+ \foreach \x in {.3,.4,...,1.2}
+ {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);}
+ %\draw [line width=.5mm,black!50!white] (.3,1.2) -- +(.4,0);
+ \end{scope}
+ %
+ \draw[->] (2.6,.7) -- +(1,0);% node[midway,above] {scale=97\%};
+ %
+ \begin{scope}[yshift=2mm,xshift=4cm]
+ \draw (0,0) |- (1.5,1.1) |- cycle;
+ \begin{scope}[yshift=-1.8mm,xshift=-1.5mm,scale=.97]
+ \draw[line width=.02pt] (.178,.25) |- (.922,1.25) |- cycle;
+ \foreach \x in {.3,.4,...,.9}
+ {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);}
+ \draw [line width=.5mm,black!50!white] (.3,1.1) -- +(.5,0);
+ \begin{scope}[xshift=7.5mm]
+ \draw[line width=.02pt] (.178,.25) |- (.922,1.25) |- cycle;
+ \foreach \x in {.3,.4,...,1.2}
+ {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);}
+ \end{scope}
+ \end{scope}
+ \end{scope}
+\end{tikzpicture}
+\end{center}
+
+It removes white strips around text, so that it does not need to scale
+down the original document too much. All margins in the resulting PDF
+can be adapted using various options. The number of rows and columns
+of pages can be modified using options \verb+-x+ and \verb+-y+. By
+default, the output file is in landscape mode, but this can be changed
+using option \verb+-l=no+.
+
+Computing the boundig box is performed automatically using
+GhostScript. This may take time for long documents, but it is often
+sufficient to compute the bounding box on the first few pages, using
+option \verb+-bb+. Bounding-box computation can be turned off (so that
+original margins are kept) using \verb+-kbb+.
+
+It is possible to only include a subset of pages using option
+\verb+-p+ (notice that if a page is listed twice, it will be included
+twice).
+
+\section{Creating a booklet}
+\pdfxup can create booklets: this is similar to the operation above,
+but the pages are ordered and oriented in the adequate way. Booklet
+mode is triggered with the \verb+-b+ option.
+\begin{center}
+\begin{tikzpicture}[scale=1.5]
+ \begin{scope}
+ \draw (0,0) |- (1.1,1.5) |- cycle;
+ \foreach \x in {.3,.4,...,.9}
+ {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);}
+ \draw [line width=.5mm,black!50!white] (.3,1.1) -- +(.5,0);
+ \end{scope}
+ \begin{scope}[xshift=1.2cm]
+ \draw (0,0) |- (1.1,1.5) |- cycle;
+ \foreach \x in {.3,.4,...,1.2}
+ {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);}
+ %\draw [line width=.5mm,black!50!white] (.3,1.2) -- +(.4,0);
+ \end{scope}
+ %
+ \draw[->] (2.6,.7) -- +(1,0);% node[midway,above] {scale=97\%};
+ %
+ \begin{scope}[yshift=2mm,xshift=4cm]
+ \draw (0,0) |- (1.5,1.1) |- cycle;
+ \begin{scope}[yshift=-1.8mm,xshift=6mm,scale=.97]
+% \draw[line width=.02pt] (.178,.25) |- (.922,1.25) |- cycle;
+ \foreach \x in {.3,.4,...,.9}
+ {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);}
+ \draw [line width=.5mm,black!50!white] (.3,1.1) -- +(.5,0);
+ \end{scope}
+ \fill[white] (1.2,-.01) -| (1.51,.3) -- cycle;
+ \draw[fill=white] (1.2,0) .. controls +(40:2mm) and +(-60:2mm) .. (1.2,.35) -- (1.5,.3) -- cycle;
+ \begin{scope}
+ \draw[clip] (1.2,0) .. controls +(40:2mm) and +(-60:2mm) .. (1.2,.35) -- (1.5,.3) -- cycle;
+ \draw[line width=.5mm,black!50!white] (1.3,.3) .. controls +(-60:1mm) and +(90:2mm) .. ++(-80:3mm);
+ \draw[line width=.5mm,black!50!white] (1.38,.28) .. controls +(-69:1mm) and +(90:2mm) .. ++(-80:3mm);
+ \end{scope}
+ \end{scope}
+\end{tikzpicture}
+\end{center}
+
+\section{Watermarking}
+Using option \verb+-w+, you can add watermarking to the original file:
+\begin{center}
+\begin{tikzpicture}[scale=1.5]
+ \begin{scope}
+ \draw (0,0) |- (1.1,1.5) |- cycle;
+ \foreach \x in {.3,.4,...,.9}
+ {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);}
+ \draw [line width=.5mm,black!50!white] (.3,1.1) -- +(.5,0);
+ \end{scope}
+ \begin{scope}[xshift=1.2cm]
+ \draw (0,0) |- (1.1,1.5) |- cycle;
+ \foreach \x in {.3,.4,...,1.2}
+ {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);}
+ %\draw [line width=.5mm,black!50!white] (.3,1.2) -- +(.4,0);
+ \end{scope}
+ %
+ \draw[->] (2.6,.7) -- +(1,0);% node[midway,above] {scale=97\%};
+ %
+ \begin{scope}[yshift=2mm,xshift=4cm]
+ \draw (0,0) |- (1.5,1.1) |- cycle;
+ \begin{scope}[yshift=-1.8mm,xshift=-1.5mm,scale=.97]
+ \path (.178,.5) -- (.922,1) node[midway,sloped,opacity=.5]
+ {\bfseries\large draft};
+ \draw[line width=.02pt] (.178,.25) |- (.922,1.25) |- cycle;
+ \foreach \x in {.3,.4,...,.9}
+ {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);}
+ \draw [line width=.5mm,black!50!white] (.3,1.1) -- +(.5,0);
+ \begin{scope}[xshift=7.5mm]
+ \path (.178,.5) -- (.922,1) node[midway,sloped,opacity=.5]
+ {\bfseries\large draft};
+ \draw[line width=.02pt] (.178,.25) |- (.922,1.25) |- cycle;
+ \foreach \x in {.3,.4,...,1.2}
+ {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);}
+ \end{scope}
+ \end{scope}
+ \end{scope}
+\end{tikzpicture}
+\end{center}
+
+
+\pdfxup has many other options, setting up margins, frames, order of pages,~...
+Please look at the \texttt{man} page for more details.
+
+
+\end{document}
diff --git a/Master/texmf-dist/doc/support/pdfxup/doc/pdfxup.pdf b/Master/texmf-dist/doc/support/pdfxup/doc/pdfxup.pdf
new file mode 100644
index 00000000000..7fda750bff7
--- /dev/null
+++ b/Master/texmf-dist/doc/support/pdfxup/doc/pdfxup.pdf
Binary files differ