summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/pdfjam-slides3up.1
blob: 09227631a100486a1ab5f37ddde009ed285f93d8 (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
.TH "pdfjam-slides3up" "1" "10 March 2010" "" "" 
.SH "NAME" 
pdfjam-slides3up \- put presentation slides onto 3-up pages
.SH "SYNOPSIS" 
.PP 
pdfjam-slides3up [--pagenumbering SWITCH] [OPTION [OPTION] \&.\&.\&.] [SRC [PAGESPEC] [SRC [PAGESPEC]] \&.\&.\&.] 
.PP 
.SH "DESCRIPTION" 
.PP 
pdfjam-slides3up converts PDF files whose pages are presentation slides (with
4:3 aspect ratio) into 3-up versions suitable for making a handout with space
for handwritten side notes
(for example).  By default, the 3-up pages do not themselves have page numbers.
.PP
To put page numbers on the output pages, use either '--pagenumbering true'
or, for example, '--pagenumbering 3.4cm' to place the page numbers a bit
lower on the page than the default position.  The value of 'SWITCH' must
be either 'true', 'false' or a dimension that can be used by LateX. (To
be precise, it's the value of the 'footskip' dimension in LaTeX; by default,
pdfjam-slides3up sets that as 3.1cm, which works pretty well in 
conjunction with both '--paper a4paper' and '--paper letterpaper'.)
.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 
pdfjam-slides3up 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 package, is required\&.
.PP 
pdfjam-slides3up 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 '-3up' applied to their names by default.  To change the suffix,
use the '--suffix' option, for example
.PP
.RS
.B    pdfjam-slides3up --suffix '1x3' --batch myslides1.pdf myslides2.pdf
.RE
.PP 
will result in files named 'myslides1-1x3.pdf' and 'myslides2-1x3.pdf'.
.PP 
By default a narrow line frame is printed around every slide.  This can be 
turned off if required by using the option '--frame false'.
.PP
pdfjam-slides3up 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 other 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
pdfjam-slides3up 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) pdfjam-slides6up(1) \&.
.PP 
.SH "AUTHOR" 
.PP 
pdfjam-slides3up is written and maintained by David Firth as part of the PDFjam package\&.