Debian Codegraph @

upstream/fedora-44/man1/psnup.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.1.
2 .TH PSNUP "1" "February 2023" "psnup 2.10" "User Commands"
3 .SH NAME
4 psnup - put multiple pages of a PostScript document on to one page
5 .SH SYNOPSIS
6 .B psnup
7 [\fI\,OPTION\/\fR...] \fI\,-NUP \/\fR[\fI\,INFILE \/\fR[\fI\,OUTFILE\/\fR]]
8 .SH DESCRIPTION
9 Put multiple pages of a PostScript document on to one page.
10 .TP
11 \fB\-NUMBER\fR
12 number of pages to impose on each output page
13 .TP
14 \fB\-p\fR, \fB\-\-paper\fR=\fI\,PAPER\/\fR
15 output paper name or dimensions
16 .TP
17 \fB\-P\fR, \fB\-\-inpaper\fR=\fI\,PAPER\/\fR
18 input paper name or dimensions
19 .TP
20 \fB\-m\fR, \fB\-\-margin\fR=\fI\,DIMENSION\/\fR
21 width of margin around each output page
22 [default 0pt]; useful for thumbnail sheets,
23 as the original page margins will be shrunk
24 .TP
25 \fB\-b\fR, \fB\-\-border\fR=\fI\,DIMENSION\/\fR
26 width of border around each input page
27 .TP
28 \fB\-d\fR, \fB\-\-draw\fR[=\fI\,DIMENSION\/\fR]
29 draw a line of given width around each page
30 [relative to input page size; argument defaults to
31 1pt; default is no line]
32 .TP
33 \fB\-l\fR, \fB\-\-rotatedleft\fR
34 input pages are rotated left 90 degrees
35 .TP
36 \fB\-r\fR, \fB\-\-rotatedright\fR
37 input pages are rotated right 90 degrees
38 .TP
39 \fB\-f\fR, \fB\-\-flip\fR
40 swap output pages' width and height
41 .TP
42 \fB\-c\fR, \fB\-\-transpose\fR
43 swap columns and rows (column\-major order)
44 .TP
45 \fB\-t\fR, \fB\-\-tolerance\fR=\fI\,NUMBER\/\fR
46 maximum wasted area in square pt [default: 100,000]
47 .TP
48 \fB\-q\fR, \fB\-\-quiet\fR
49 don't show page numbers being output
50 .TP
51 \fB\-\-help\fR
52 display this help and exit
53 .TP
54 \fB\-v\fR, \fB\-\-version\fR
55 display version information and exit
56 .PP
57 psnup aborts with an error if it cannot arrange the input pages so as to
58 waste less than the given tolerance.
59 .PP
60 The output paper size defaults to the input paper size; if that is not given,
61 the default given by the `paper' command is used.
62 .PP
63 The input paper size defaults to the output paper size.
64 .PP
65 In row\-major order (the default), adjacent pages are placed in rows across
66 the paper; in column\-major order, they are placed in columns down the page.
67 .PP
68 .B psnup
69 uses
70 .B pstops
71 to impose multiple logical pages on to each physical sheet of paper.
72 .PP
73 Paper sizes can be given either as a name (see
74 .BR paper(1) )
75 or as \fBwidth\fRx\fBheight\fR (see
76 .BR psutils (1)
77 for the available units).
78
79 .SS "Exit status:"
80 .TP
81 0
82 if OK,
83 .TP
84 1
85 if arguments or options are incorrect, or there is some other problem
86 starting up,
87 .TP
88 2
89 if there is some problem during processing, typically an error reading or
90 writing an input or output file.
91 .SH EXAMPLES
92 The potential use of this utility is varied but one particular
93 use is in conjunction with
94 .BR psbook (1).
95 For example, using groff to create a PostScript document and lpr as
96 the
97 .SM UNIX
98 print spooler a typical command line might look like this:
99 .sp
100 groff -Tps -ms \fIfile\fP | psbook | psnup -2 | lpr
101 .sp
102 where file is a 4 page document this command will result in a
103 two page document printing two pages of \fIfile\fP per page and
104 rearranges the page order to match the input pages 4 and 1
105 on the first output page and
106 pages 2 then 3 of the input document
107 on the second output page.
108 .SH AUTHOR
109 Written by Angus J. C. Duggan and Reuben Thomas.
110 .SH COPYRIGHT
111 Copyright \(co Reuben Thomas 2016\-2022.
112 Released under the GPL version 3, or (at your option) any later version.
113 .SH TRADEMARKS
114 .B PostScript
115 is a trademark of Adobe Systems Incorporated.
116 .SH "SEE ALSO"
117 .BR psutils (1),
118 .BR paper (1)