summaryrefslogtreecommitdiff
path: root/support/pdfjam/man1/pdfnup.1
blob: 86953387e899590db00ffed9bf96537d574c698e (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
.TH "pdfnup" "1" "10 March 2010" "" "" 
.SH "NAME" 
pdfnup \- n-up the pages of pdf files
.SH "SYNOPSIS" 
.PP 
pdfnup [OPTION [OPTION] \&.\&.\&.] [SRC [PAGESPEC] [SRC [PAGESPEC]] \&.\&.\&.]
.PP 
.SH "DESCRIPTION" 
.PP 
pdfnup converts files in the Adobe Portable Document Format (PDF)
to "n-up" PDF files, that is, with multiple input pages 
per output page, for
more economical printing etc\&.  The default processing is to 2-up 
landscape output with no frame around pages, equivalent to using the 
options '--nup 2x1 --landscape true --frame false'.
.PP
If no source PDF file ('SRC') is specified, input
is from /dev/stdin. If 'PAGESPEC' is omitted, all pages are processed.
.PP
Source files are processed sequentially into a single output
unless the '--batch' option is used, in which case they are processed 
separately.
.PP 
pdfnup operates on one or more PDF files, and (either with the '--batch' 
option or with '--outfile DIR' where 'DIR' is a directory) the 
resulting files have
the suffix '-nup' applied to their names by default.  To change 
the suffix,
use the '--suffix' option, for example
.PP
.RS
.B    pdfnup --nup 2x2 --suffix '2x2' --batch myfile1.pdf myfile2.pdf
.RE
.PP 
will result in files named 'myfile1-2x2.pdf' and 'myfile2-2x2.pdf'.
.PP 
pdfnup is a simple wrapper for pdfjam, which provides a front end to many of the capabilities of the pdfpages
package for pdflatex\&.  A working installation of pdflatex, with
the pdfpages and geometry packages, is required\&.
.PP 
pdfnup is part of the "PDFjam" package of tools, whose homepage is at
http://www.warwick.ac.uk/go/pdfjam \&.
.PP
.SH "SETUP" 
.PP
See http://go.warwick.ac.uk/pdfjam .
.PP
.SH "USAGE" 
.PP 
For the available options and site/user defaults, see the output of 
.PP
.RS
.B    pdfjam --help
.RE
.PP 
For further information and some examples see 
http://go.warwick.ac.uk/pdfjam .
.PP
.SH "LIMITATIONS AND BUGS" 
.PP
pdfnup does not work with encrypted PDF files, and does not 
preserve hyperlinks.
.PP 
Please report bugs! See the website at
http://www.warwick.ac.uk/go/pdfjam \&.
.PP 
.SH "LICENSE" 
.PP 
PDFjam is distributed under the GNU public license\&.
.PP 
.SH "SEE ALSO" 
.PP 
pdfjam(1) pdfpun(1) \&.
.PP 
.SH "AUTHOR" 
.PP 
pdfnup is written and maintained by David Firth as part of the PDFjam package\&.