psnup(1) - f38

1PSNUP(1)                         User Commands                        PSNUP(1)
2
3
4

NAME

6       psnup - put multiple pages of a PostScript document on to one page
7

SYNOPSIS

9       psnup [OPTION...] -NUP [INFILE [OUTFILE]]
10

DESCRIPTION

12       Put multiple pages of a PostScript document on to one page.
13
14       -NUMBER
15              number of pages to impose on each output page
16
17       -p, --paper=PAPER
18              output paper name or dimensions
19
20       -P, --inpaper=PAPER
21              input paper name or dimensions
22
23       -m, --margin=DIMENSION
24              width  of  margin  around each output page [default 0pt]; useful
25              for thumbnail sheets, as  the  original  page  margins  will  be
26              shrunk
27
28       -b, --border=DIMENSION
29              width of border around each input page
30
31       -d, --draw[=DIMENSION]
32              draw  a  line of given width around each page [relative to input
33              page size; argument defaults to 1pt; default is no line]
34
35       -l, --rotatedleft
36              input pages are rotated left 90 degrees
37
38       -r, --rotatedright
39              input pages are rotated right 90 degrees
40
41       -f, --flip
42              swap output pages' width and height
43
44       -c, --transpose
45              swap columns and rows (column-major order)
46
47       -t, --tolerance=NUMBER
48              maximum wasted area in square pt [default: 100,000]
49
50       -q, --quiet
51              don't show page numbers being output
52
53       --help display this help and exit
54
55       -v, --version
56              display version information and exit
57
58       psnup aborts with an error if it cannot arrange the input pages  so  as
59       to waste less than the given tolerance.
60
61       The  output paper size defaults to the input paper size; if that is not
62       given, the default given by the `paper' command is used.
63
64       The input paper size defaults to the output paper size.
65
66       In row-major order (the default), adjacent pages  are  placed  in  rows
67       across  the  paper;  in  column-major order, they are placed in columns
68       down the page.
69
70       psnup uses pstops to impose multiple logical pages on to each  physical
71       sheet of paper.
72
73       Paper  sizes can be given either as a name (see paper(1)) or as widthx‐
74       height (see psutils(1) for the available units).
75
76
77   Exit status:
78       0      if OK,
79
80       1      if arguments or options are incorrect, or there  is  some  other
81              problem starting up,
82
83       2      if  there  is some problem during processing, typically an error
84              reading or writing an input or output file.
85

EXAMPLES

87       The potential use of this utility is varied but one particular  use  is
88       in  conjunction  with  psbook(1).  For example, using groff to create a
89       PostScript document and lpr as the UNIX print spooler a typical command
90       line might look like this:
91
92       groff -Tps -ms file | psbook | psnup -2 | lpr
93
94       where  file is a 4 page document this command will result in a two page
95       document printing two pages of file per page and  rearranges  the  page
96       order  to  match  the  input pages 4 and 1 on the first output page and
97       pages 2 then 3 of the input document on the second output page.
98

AUTHOR

100       Written by Angus J. C. Duggan and Reuben Thomas.
101

COPYRIGHT

103       Copyright © Reuben Thomas 2016-2022.  Released under the GPL version 3,
104       or (at your option) any later version.
105

TRADEMARKS

107       PostScript is a trademark of Adobe Systems Incorporated.
108