summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-12-31 23:14:23 +0000
committerKarl Berry <karl@freefriends.org>2019-12-31 23:14:23 +0000
commitbb856019912015b530cb2e19f0d4843a5dbca897 (patch)
treed7c7bb404e0eafa4843298bed65646535c0c112e /Master/texmf-dist/doc
parent3d6c241f6ed20d838c6fa004e61e08241ae17b83 (diff)
pdfxup (31dec19)
git-svn-id: svn://tug.org/texlive/trunk@53282 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/man/man1/pdfxup.177
-rw-r--r--Master/texmf-dist/doc/man/man1/pdfxup.man1.pdfbin19180 -> 22457 bytes
-rw-r--r--Master/texmf-dist/doc/support/pdfxup/README30
-rw-r--r--Master/texmf-dist/doc/support/pdfxup/RELEASES5
-rw-r--r--Master/texmf-dist/doc/support/pdfxup/pdfxup.pdfbin6016 -> 90154 bytes
5 files changed, 75 insertions, 37 deletions
diff --git a/Master/texmf-dist/doc/man/man1/pdfxup.1 b/Master/texmf-dist/doc/man/man1/pdfxup.1
index 72da16aa97f..4286906d00b 100644
--- a/Master/texmf-dist/doc/man/man1/pdfxup.1
+++ b/Master/texmf-dist/doc/man/man1/pdfxup.1
@@ -1,8 +1,8 @@
.\" Manpage for pdfxup.
.\" Contact pdfxup@markey.fr to correct errors or typos.
-.TH man 1 "6 october 2015" "1.30" "pdfxup man page"
+.TH man 1 "31 december 2019" "1.50" "pdfxup man page"
.SH NAME
-pdfxup \- n-up PDF pages with reduced margins
+pdfxup \- n-up tool with reduced margins
.SH SYNOPSIS
pdfxup [OPTIONS] [FILE]
.SH DESCRIPTION
@@ -28,14 +28,19 @@ sets the number of columns in the output file (default 2);
\fB\-y\fR n, \fB\-\-rows\fR n
sets the number of lines in the output file (default 1);
.TP
-\fB\-l\fR (0|1), \fB\-\-landscape\fR (0|1)
+\fB\-l\fR, \fB\-\-landscape\fR
sets orientation of paper (of final document) landscape;
.TP
-\fB\-b\fR (0|1|le|se), \fB\-\-booklet\fR (0|1|le|se)
-configure for printing as a booklet. '1' is equivalent to 'le', which
-assumes that two-sided printing is in 'long-edge' mode (you turn from
-one page to the next along the long edge of the paper). 'se' is
-the 'short-edge' option;
+\fB\-b\fR (le|se), \fB\-\-booklet\fR (le|se)
+configure for printing as a booklet. Value 'le' (which is the default
+value when \fB\-b\fR is used with no argument) means that two-sided
+printing is in 'long-edge' mode (you turn from one page to the next
+along the long edge of the paper). 'se' is the 'short-edge' option.
+.TP
+\fB\-c\fR, \fB\-\-clip\fR
+clip pages to the computed bounding box. By default, content is not
+clipped, which may result in overlap of neighbouring pages. With this
+option, anything outside the bounding box will not be displayed.
.TP
\fB\-o\fR file, \fB\-\-output\fR file
name of output file;
@@ -44,7 +49,8 @@ name of output file;
ask before overwriting output file;
.TP
\fB\-fw\fR d, \fB\-\-framewidth\fR d
-width of the frame around each page (default 0.4pt);
+width of the frame around each page (default 0.4pt). Set to 0pt to have no
+frame at all;
.TP
\fB\-im\fR d, \fB\-\-innermargins\fR d
inner margin between frame and page (default 5pt);
@@ -52,24 +58,38 @@ inner margin between frame and page (default 5pt);
\fB\-m\fR d, \fB\-\-margins\fR d
margin of pages of the new document (default 5pt);
.TP
-\fB\-is\fR d, \fB\-\-intspacess\fR d
+\fB\-is\fR d, \fB\-\-intspaces\fR d
space between different pages (default 1pt);
.TP
-\fB\-p\fR a-b, \fB\-\-pages\fR a-b
-only consider pages a to b of input document;
+\fB\-p\fR list, \fB\-\-pages\fR list
+only consider sublist of pages of input document. List is a
+comma-separated list of pages or ranges pages of the form a-b; a can
+be omitted to start from first page, and b can be omitted to end at
+the last page. Therefore, "\fB\-p\fR -" (which is the default)
+includes all pages. Also allows modulo, so that "\fB\-p\fR 0%2" would
+include only even-numbered pages.
.TP
-\fB\-bb\fR a-b, \fB\-\-pages\fR a-b
-only consider pages a to b of input document for computing bounding box;
+\fB\-bb\fR list, \fB\-\-bb\fR list
+only consider sublist of pages of input document for computing bounding box;
.TP
-\fB\-nobb\fR a-b, \fB\-\-no-bb\fR a-b
-omit pages a to b of input document from computation of bounding box;
+\fB\-nobb\fR list, \fB\-\-no-bb\fR list
+omit list of pages of input document from computation of bounding box;
.TP
-\fB\-g\fR (0|1), \fB\-\-get-bb\fR (0|1)
+\fB\-g\fR, \fB\-\-get-bb\fR
only compute (and output) bounding box;
.TP
\fB\-s\fR x y W H, \fB\-\-set-bb\fR x y W H
set the bounding box to the given values;
.TP
+\fB\-w\fR file, \fB\-\-watermark\fR file
+use file as background watermark. file can be any format accepted by
+pdflatex (e.g. png or pdf). If file is a multipage PDF file, page n of
+the watermark file is used with page n of the input file, and the last
+page of the watermark file is repeated if the input file has more pages;
+.TP
+\fB\-wp\fR p, \fB\-\-watermark-period\fR p
+repeat the last p pages of the watermark file instead of only the last one;
+.TP
\fB\-d\fR, \fB\-\-debug\fR
debug mode: keep intermediary files;
.TP
@@ -77,17 +97,32 @@ debug mode: keep intermediary files;
select verbosity (default: 1);
.TP
\fB\-q\fR, \fB\-\-quiet\fR
-run quietly (equiv. '-V=0')
+run quietly (equiv. '-V=0');
.TP
\fB\-v\fR, \fB\-\-version\fR
print version number and exit;
.TP
\fB\-h\fR, \fB\-\-help\fR
print help message and exit.
-
+.SH EXAMPLES
+.TP
+\fB# pdfxup file.pdf\fR
+produces 2-up pdf file from file.pdf
+.TP
+\fB# pdfxup -bb 1-4 file.pdf\fR
+same behaviour, but computes the bounding box only using the
+first 4 pages (this saves time when processing long documents)
+.TP
+\fB# pdfxup -b -o booklet.pdf file.pdf\fR
+same behaviour, but creates a booklet (as booklet.pdf)
+.TP
+\fB# pdfxup -kbb -x1 -y2 -l0 beamer-frames.pdf\fR
+arranges 2 beamer frames per page (not reducing margins)
+.TP
+\fB# pdfxup -kbb -x2 -y2 -l beamer-frames.pdf:1-12,15-19\fR
+arranges 4 beamer frames per page (not reducing margins), including
+only frames 1 to 12 and 15 to 19.
.SH SEE ALSO
gs(1), pdflatex(1)
-.SH BUGS
-No known bugs.
.SH AUTHOR
Nicolas Markey (pdfxup@markey.fr)
diff --git a/Master/texmf-dist/doc/man/man1/pdfxup.man1.pdf b/Master/texmf-dist/doc/man/man1/pdfxup.man1.pdf
index b8a1e06463f..31630c95154 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 63d426a25c8..9bbe0d49f2e 100644
--- a/Master/texmf-dist/doc/support/pdfxup/README
+++ b/Master/texmf-dist/doc/support/pdfxup/README
@@ -1,26 +1,24 @@
-PDFXUP -- v1.30 (2015/10/06)
+PDFXUP -- v1.50 (2019/12/31)
N. Markey <pdfxup@markey.fr>
-pdfxup is a unix/linux shell script that creates a PDF
-document where each page is obtained by combining several
-pages of a PDF file given as output. The important feature
-of pdfxup, compared to similar programs, is that it tries to
-compute the (global) bounding box of the input PDF file, in
-order to remove the margins and to keep the text only.
-Instead of having the font size divided by 2 (for the case
-of 2-up output), in some case you may end up with the same
-font size as in the original document (as is the case for a
-default 'article' document produced by LaTeX).
+pdfxup is a bash shell script that creates a PDF document where each
+page is obtained by combining several pages of a PDF file given as
+output. The important feature of pdfxup, compared to similar programs,
+is that it tries to compute the (global) bounding box of the input PDF
+file, in order to remove the margins and to keep the text only.
+Instead of having the font size divided by 2 (for the case of 2-up
+output), in some case you may end up with the same font size as in the
+original document (as is the case for a default 'article' document
+produced by LaTeX).
-pdfxup uses ghostscript for computing the maximal bounding
-box of (some of) the pages of the document, and then uses
-pdflatex (with graphicx package) in order to produce the new
-document.
+pdfxup uses ghostscript for computing the maximal bounding box of
+(some of) the pages of the document, and then uses pdflatex (with
+graphicx package) in order to produce the new document.
-%% (c) 2015/10/06 Nicolas Markey <pdfxup at markey dot fr>
+%% (c) 2019/12/31 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 ea248f6c4ad..15c8903b46e 100644
--- a/Master/texmf-dist/doc/support/pdfxup/RELEASES
+++ b/Master/texmf-dist/doc/support/pdfxup/RELEASES
@@ -23,3 +23,8 @@ v1.30 (2015/10/06)
- added options -g and -s for getting and then manually
- setting bounding box.
- created man page
+
+v1.50 (2019/12/31)
+ - added the -c option (to clip pages)
+ - corrected + improved option -p
+ - added watermarking \ No newline at end of file
diff --git a/Master/texmf-dist/doc/support/pdfxup/pdfxup.pdf b/Master/texmf-dist/doc/support/pdfxup/pdfxup.pdf
index a2466a429b5..d51a6c1ca42 100644
--- a/Master/texmf-dist/doc/support/pdfxup/pdfxup.pdf
+++ b/Master/texmf-dist/doc/support/pdfxup/pdfxup.pdf
Binary files differ