Debian Codegraph @

upstream/debian-unstable/man1/psnup.1

raw
1 .TH PSNUP "1" "2025\-09\-08" "psutils 3.3.14" "User Commands"
2 .SH NAME
3 psnup
4 .SH SYNOPSIS
5 .B psnup
6 [OPTION...] -NUMBER [INFILE [OUTFILE]]
7 .SH DESCRIPTION
8 .PP
9 .B psnup
10 uses
11 .B pstops
12 to impose multiple logical pages on to each physical sheet of paper.
13 .PP
14 Paper sizes can be given either as a name (see
15 .BR paper(1) )
16 or as \fBwidth\fRx\fBheight\fR (see
17 .BR psutils (1)
18 for the available units).
19 Put multiple pages of a PostScript document on to one page.
20
21 .TP
22 \fB\-NUMBER\fR
23 number of pages to impose on each output page
24
25 .TP
26 \fBINFILE\fR
27 `\-' or no INFILE argument means standard input
28
29 .TP
30 \fBOUTFILE\fR
31 `\-' or no OUTFILE argument means standard output
32
33 .SH OPTIONS
34 .TP
35 \fB\-p\fR \fI\,PAPER\/\fR, \fB\-\-paper\fR \fI\,PAPER\/\fR
36 output paper name or dimensions (WIDTHxHEIGHT)
37
38 .TP
39 \fB\-P\fR \fI\,INPAPER\/\fR, \fB\-\-inpaper\fR \fI\,INPAPER\/\fR
40 input paper name or dimensions (WIDTHxHEIGHT)
41
42 .TP
43 \fB\-m\fR \fI\,DIMENSION\/\fR, \fB\-\-margin\fR \fI\,DIMENSION\/\fR
44 width of margin around each output page
45 [default 0pt]; useful for thumbnail sheets,
46 as the original page margins will be shrunk
47
48 .TP
49 \fB\-b\fR \fI\,DIMENSION\/\fR, \fB\-\-border\fR \fI\,DIMENSION\/\fR
50 width of border around each input page
51
52 .TP
53 \fB\-d\fR \fI\,[DIMENSION]\/\fR, \fB\-\-draw\fR \fI\,[DIMENSION]\/\fR
54 draw a line of given width (relative to original
55 page) around each page [argument defaults to 1pt;
56 default is no line; width is fixed for PDF]
57
58 .TP
59 \fB\-l\fR, \fB\-\-rotatedleft\fR
60 input pages are rotated left 90 degrees
61
62 .TP
63 \fB\-r\fR, \fB\-\-rotatedright\fR
64 input pages are rotated right 90 degrees
65
66 .TP
67 \fB\-f\fR, \fB\-\-flip\fR
68 swap output pages' width and height
69
70 .TP
71 \fB\-c\fR, \fB\-\-transpose\fR
72 swap columns and rows (column\-major order)
73
74 .TP
75 \fB\-t\fR \fI\,NUMBER\/\fR, \fB\-\-tolerance\fR \fI\,NUMBER\/\fR
76 maximum wasted area in square pt [default: 100000]
77
78 .TP
79 \fB\-v\fR, \fB\-\-version\fR
80 show program's version number and exit
81
82 .TP
83 \fB\-q\fR, \fB\-\-quiet\fR
84 don't show progress
85
86 .SH COMMENTS
87 psnup aborts with an error if it cannot arrange the input pages so as to
88 waste less than the given tolerance.
89
90 The output page size defaults to the input page size; if none is specified
91 in the document or on the command line, the default given by the `paper'
92 command is used.
93
94 The input page size defaults to the output page size.
95
96 In row\-major order (the default), adjacent pages are placed in rows
97 across the paper; in column\-major order, they are placed in columns down
98 the page.
99 .SH EXAMPLES
100 The potential use of this utility is varied but one particular
101 use is in conjunction with
102 .BR psbook (1).
103 For example, using groff to create a PostScript document and lpr as
104 the
105 .SM UNIX
106 print spooler a typical command line might look like this:
107 .sp
108 groff -Tps -ms \fIfile\fP | psbook | psnup -2 | lpr
109 .sp
110 where file is a 4 page document this command will result in a
111 two page document printing two pages of \fIfile\fP per page and
112 rearranges the page order to match the input pages 4 and 1
113 on the first output page and
114 pages 2 then 3 of the input document
115 on the second output page.
116
117 .SH AUTHOR
118 .nf
119 Reuben Thomas <[email protected]>
120 .fi