summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/pdfxup.1
blob: 72da16aa97fc3cba59ab2aa37603203de3b564d4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
.\" Manpage for pdfxup.
.\" Contact pdfxup@markey.fr to correct errors or typos.
.TH man 1 "6 october 2015" "1.30" "pdfxup man page"
.SH NAME
pdfxup \- n-up PDF pages with reduced margins
.SH SYNOPSIS
pdfxup [OPTIONS] [FILE]
.SH DESCRIPTION
pdfxup 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 almost 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.
.SH OPTIONS
pdfxup accepts numerous options. The most important ones are:
.\" additional options should be lister here...
.TP
\fB\-x\fR n, \fB\-\-columns\fR n
sets the number of columns in the output file (default 2);
.TP
\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)
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;
.TP
\fB\-o\fR file, \fB\-\-output\fR file
name of output file;
.TP
\fB\-i\fR
ask before overwriting output file;
.TP
\fB\-fw\fR d, \fB\-\-framewidth\fR d
width of the frame around each page (default 0.4pt);
.TP
\fB\-im\fR d, \fB\-\-innermargins\fR d
inner margin between frame and page (default 5pt);
.TP
\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
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;
.TP
\fB\-bb\fR a-b, \fB\-\-pages\fR a-b
only consider pages a to b 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;
.TP
\fB\-g\fR (0|1), \fB\-\-get-bb\fR (0|1)
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\-d\fR, \fB\-\-debug\fR
debug mode: keep intermediary files;
.TP
\fB\-V [0-3]\fR, \fB\-\-verbose\fR [0-3]
select verbosity (default: 1);
.TP
\fB\-q\fR, \fB\-\-quiet\fR
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 SEE ALSO
gs(1), pdflatex(1)
.SH BUGS
No known bugs.
.SH AUTHOR
Nicolas Markey (pdfxup@markey.fr)